跳到主要内容
所有帖子作者

Jeff ErnstFriedman

OpenAPI Initiative 技术指导委员会发布 OASv3.0.2

作者 博客

OpenAPI Initiative 成员 技术指导委员会 宣布了 OpenAPI 规范 3.0.2 的最新版本。注意:此版本是修补程序版本,这些修改不会改变规范的行为。

作为修补程序版本,最新的更改是为了在可读性和准确性方面改进规范。请阅读我们 GitHub 仓库的发布说明 此处

如果您有兴趣 参与规范开发,请在太平洋时间星期四上午 9 点加入我们,参加技术指导委员会的公开会议。

  • 为地图中键的区分大小写添加了说明。
  • 重新设计了数据类型表,删除了通用名称以减少潜在的混淆。
  • 澄清了服务器变量对象的 default 字段的描述。
  • 修复了各种示例。
  • 澄清了 operationId 区分大小写。
  • 澄清了参数对象的 deprecated 字段的默认值为 false。
  • 建议不要使用参数对象的 allowEmptyValue 字段,因为它将在未来版本中删除。
  • 修复了媒体类型对象的 schema 字段的描述。
  • 澄清了响应对象的响应代码字段描述。
  • 澄清了 Schema 对象的 additionalProperties 字段的默认值为 true。
  • 修复了鉴别器对象描述中的一处小问题。
  • 修复了安全方案对象描述,以包含对在 cookie 中使用 API 密钥的引用。
  • 修复了安全需求对象的描述。

参加年度 API 大会的主要原因

作者 博客

API 策略与实践大会,称为 APIStrat,是一场专注于 API 经济的大会,汇聚了专家、领导者和社区成员,讨论我们每天在地面上看到的内容。9 月 24 日至 26 日在田纳西州纳什维尔举行,这是一场你一定不能错过的会议。

我们想向您介绍我们认为您应该参加该活动的主要原因。而且,如果您 **今天(9 月 14 日)** 注册,您可以额外节省 200 美元。不要等!

以下是在此活动中您想要获得的最佳原因

 

  1. API 空间及其他领域的新趋势和创新: 在了解 API 空间的最新趋势的同时,您还可以从演讲者那里听到对我们今天生活其中的科技世界的更广阔的视角,包括主题演讲嘉宾纽约州立大学奥尔巴尼分校政治学副教授 Virginia Eubanks 讨论 自动化不平等:高科技工具如何对穷人进行画像、警察和惩罚以及像素与位置一书的作者和 KO Insights 负责人 Kate O’Neill 讨论 技术人道主义:融合、自动化和人类体验的未来。
  2. 了解 API 空间的最佳实践: 大会将揭示 API 作为产品、API 门户、API 设计和 API 可用性的最佳实践。一些主题演讲和演讲包括将企业转变为 API 平台;像独角兽一样使用 Envoy、Istio 和 Kubernetes 进行微服务化;以及 API 的演变:在需求仍在变化时进行设计。参加活动并带走您可以立即使用的想法!
  3. 田纳西州纳什维尔:美国的音乐之都有很多很棒的事情可以做、看和吃!这里有诸如大奥普里、乡村音乐名人堂和蓝草音乐的 The Station Inn 等经典场所。当然,如果您喜欢美食、饮品、音乐、历史和鬼魂(每个城镇都必须有一个!),这里还有很多有趣的步行游览!纳什维尔绝对是大多数人旅行愿望清单上的城市,所以把它划掉,参加一场很棒的会议吧。也许您还会在 The Listening Room Cafe 发现一颗冉冉升起的新星。
  4. 动手实践研讨会如果您是通过实践学习的人,有很多很棒的动手实践研讨会您可以参加,从 API 的实用 SecDevOps 到将外部服务转变为内部 API。无论您是经验丰富的 API 从业者还是刚入门,这里都有适合您的研讨会。
  5. 社交活动和人脉拓展:参加此活动或任何 Linux Foundation 活动的首选之一是提供的社交活动,例如我们的 趣味跑步(您也可以步行或慢跑)。此外,这是一个与同行建立人脉的好地方,许多人将 APIStrat 的走廊交流视为年复一年参加活动的首要原因之一。
  6. 多样性和包容性我们希望确保每个人在我们的会议上都感到宾至如归并安全。我们提供特殊物品,如静音室,如果您需要一个不允许交谈和互动的物理空间,哺乳室和儿童保育,以及特殊的通信贴纸和其他功能,使此活动尽可能地易于访问。
  7. OAS 研讨会:在我们拥有的大量很棒的研讨会中,我们还举办了两个独特的 OAS 研讨会。初学者研讨会是 关于 OpenAPI 规范 3.0 的动手实践介绍。在介绍环节结束后,将是 OAS 高级用户研讨会,并将以未来发布的哪些功能作为结束。这些研讨会的参与者将获得对 OASv3 的工作知识,OASv3 已成为 描述 API 的事实上的标准

查看完整的演讲者阵容 此处,并在 此处 注册。

APIStrat 2018 高级 OpenAPI 规范技术概述/研讨会

作者 博客

请加入我们,参加关于 OpenAPI 3.0 的高级动手实践研讨会。请务必带上自己的笔记本电脑参加。这将是一场 OpenAPI 规范技术概述/研讨会。

一个关于更高级功能和 3.0 特定功能的动手实践培训课程,适合已经了解 v2 并想了解当前版本新增内容的开发人员。以对未来版本的预览结束。

您将了解

  1. Schema 对象
  2. 外部引用
  3. 表单数据
  4. 链接和回调
  5. 安全方案
  6. XmlExample
Ron Ratovsky
SmartBear Swagger 开发者布道师
Ron 是 OpenAPI Initiative 技术指导委员会的技术联络人
Ted Epstein
RepreZen 首席执行官
RepreZen 首席执行官 Ted Epstein 在帮助组织成功实施 API 策略和架构方面拥有超过 10 年的经验。Ted 作为理事会成员参与 OpenAPI 技术设计社区,并领导 RAPID-ML 的架构,RAPID-ML 是第一个将领域驱动设计的力量带到 REST API 的 API 描述语言。Ted 是 API-Craft NYC 聚会的联合组织者,并在 QCon、EclipseCon、APIStrat、API-Craft 和数据建模区等会议上发言。
Emmanuel Paraskakis
Oracle API 平台产品管理高级总监
Emmanuel 在为客户提供 API 方面拥有超过 10 年的经验,并且是 API 社区的热情成员。过去三年,他一直在 Apiary(最近被 Oracle 收购)中设计 API 工具。目前,他领导着 Oracle API 平台的产品管理,该平台是为 API 提供者和使用者提供的全生命周期产品套件。他也是 API Craft 旧金山 Meetup Group 的组织者,该小组拥有超过 1,000 名成员。

APIStrat 2018 入门级 OpenAPI 规范技术概述/研讨会

作者 博客

请加入我们,参加 关于 OpenAPI 3.0 的动手实践研讨会,该研讨会将于 9 月 24 日在纳什维尔举行的 APIStrat 2018 上举行。您可以只参加此环节,也可以在之后参加高级研讨会。请务必带上自己的笔记本电脑参加。这将是一场 OpenAPI 规范技术概述/研讨会 - 一个介绍 OpenAPI 基本功能及其最常用功能的动手实践培训课程。

您将了解

  1. 什么是 OpenAPI 3.0
  2. OpenAPI 和服务器对象
  3. 路径和路径参数
  4. GET 操作和响应
  5. 查询和标头参数
  6. POST、PATCH 和 PUT
  7. 使用 markdown 进行文档编写

Ron Ratovsky
SmartBear Swagger 开发者布道师
Ron 是 OpenAPI Initiative 技术指导委员会的技术联络人
Ted Epstein
RepreZen 首席执行官
RepreZen 首席执行官 Ted Epstein 在帮助组织成功实施 API 策略和架构方面拥有超过 10 年的经验。Ted 作为理事会成员参与 OpenAPI 技术设计社区,并领导 RAPID-ML 的架构,RAPID-ML 是第一个将领域驱动设计的力量带到 REST API 的 API 描述语言。Ted 是 API-Craft NYC 聚会的联合组织者,并在 QCon、EclipseCon、APIStrat、API-Craft 和数据建模区等会议上发言。
Emmanuel Paraskakis
Oracle API 平台产品管理高级总监
Emmanuel 在为客户提供 API 方面拥有超过 10 年的经验,并且是 API 社区的热情成员。过去三年,他一直在 Apiary(最近被 Oracle 收购)中设计 API 工具。目前,他领导着 Oracle API 平台的产品管理,该平台是为 API 提供者和使用者提供的全生命周期产品套件。他也是 API Craft 旧金山 Meetup Group 的组织者,该小组拥有超过 1,000 名成员。

说服你的老板让你参加 APIStrat

作者 博客

API 策略与实践,更广为人知的是 APIStrat,*汇聚了从对 API 感兴趣的人到今天的领导者在内的所有人,讨论 API 空间的机会和挑战。APIStrat 在 API 提供者和 API 使用者、初创公司和企业、开发人员和架构师以及各种类型的集成商之间引发了对话。* 该活动涵盖了 API 生命周期,以及围绕渐进式 Web 应用程序、离线优先方法以及最终用户故事的最佳实践。这场由 OpenAPI Initiative 主办的会议,是 API 设计事实标准的策展人:OpenAPI 规范包括关于 Kubernetes、GraphQL、RPC、JSON、微服务、超媒体以及如何最好地实施它们的演讲。

我们理解您很忙,可能没有时间或不知道如何跟您的老板谈论送您参加此次会议的重要性。别担心。我们已经为您创建了一个电子邮件模板。您可以随意使用整个信函或部分内容,并告诉我们它是否帮助您参加了会议!

________________________________

您好 {老板姓名},

我想参加 APIStrat 将于 9 月 24 日至 26 日在田纳西州纳什维尔举行。该会议本质上是供应商中立的,提供案例研究、小组讨论、会议演讲和闪电演讲,探讨 API 架构和实施中的新兴趋势,重点关注能够阐明快速发展且有时复杂的领域的材料。

对我们业务最有益的主题包括 {插入最合适的主题:可访问性、应用程序开发和 API、人工智能和机器学习、社区和开发者、无服务器、国际化、物联网、性能、渐进式 Web 应用、安全、标准、测试工具和基础设施}。您可以在此处查看完整日程安排 此处.

会议的其他主题/优势包括

活动费用在 9 月 14 日之前为 599 美元。我很乐意撰写一份会议后报告,并与团队其他成员分享我学到的知识以及如何在我们的业务战略中实施工具和技术。

谢谢,

{您的姓名}

APIStrat 2018 适合所有人

作者 博客

APIStrat 2018 距离我们只有一个多月了,我对今年的阵容感到无比兴奋!节目委员会再次出色地引入了各种主题和演讲者,为从 API 生命周期各个阶段到所有技术水平的从业人员提供了机遇。在 9 月 14 日之前注册,可以节省 200 美元的会议费。来纳什维尔参加今年最顶级的 API 活动。

众所周知,没有哪个行业或垂直领域不以某种形式使用 API。由于 API 的广泛范围,这意味着每家公司都应该参与到 API 未来发展趋势的对话中。在 APIStrat,您可以直接向设计下一代 OpenAPI 规范及其支持的工具生态系统的人员学习。

按主题查看日程安排

在 APIStrat 2018 加入 Jenn Schiffer

作者 博客

加入 OpenAPI Initiative 以及数百名 API 开发人员、策略师和思想领袖,参加 APIStrat 2018,活动将于 9 月 24 日至 26 日在音乐之城举行。

APIStrat 将 API 爱好者与今天的领导者聚集在一起,探讨 API 领域的机会和挑战。APIStrat 在 API 提供者和 API 消费者、初创公司和企业、开发人员和架构师以及各种集成商之间引发了对话。

主旨演讲亮点:Jenn Schiffer


Jenn Schiffer 是一位工程师、艺术家和科技幽默家。大多数人知道她拥有惊人的力量,也知道她是 Fog Creek 公司 http://Glitch.com 的社区工程师。她组织了 JerseyScript,这是一个位于她所在的泽西城举办的每月一次的 Web 开发人员社交活动,并且创建了每个人最喜欢的免费在线像素艺术编辑器 http://Make8BitArt.com。

立即注册

无论您的企业是使用 API 还是生成 API,此次会议都是与推动 API 实施发展前沿的公司和开发人员互动的最佳机会。

期待在纳什维尔与您相见

在 APIStrat 2018 加入 Cristiano Betts

作者 博客

加入 OpenAPI Initiative 以及数百名 API 开发人员、策略师和思想领袖,参加 APIStrat 2018,活动将于 9 月 24 日至 26 日在音乐之城举行。

APIStrat 将 API 爱好者与今天的领导者聚集在一起,探讨 API 领域的机会和挑战。APIStrat 在 API 提供者和 API 消费者、初创公司和企业、开发人员和架构师以及各种集成商之间引发了对话。

主旨演讲亮点:Cristiano Betta

Cristiano 是一位开发者体验设计师,帮助大小公司改进其开发者入职、激活和支持工作。他喜欢查看出色的开发者入职流程,分析并记录常见设计实践的最佳实践和缺陷。尽管他拥有 15 年以上的开发经验,但他认为,从根本上讲,我们所有人都在某些事情上是新手,文档和入职应该反映这种理念。在过去,他曾担任承包商、初创公司创始人、活动组织者以及 PayPal 的开发者倡导者。

立即注册

无论您的企业是使用 API 还是生成 API,此次会议都是与推动 API 实施发展前沿的公司和开发人员互动的最佳机会。

期待在纳什维尔与您相见

在 APIStrat 2018 加入 Virginia Eubanks

作者 博客

加入 OpenAPI Initiative 以及数百名 API 开发人员、策略师和思想领袖,参加 APIStrat 2018,活动将于 9 月 24 日至 26 日在音乐之城举行。

APIStrat 将 API 爱好者与今天的领导者聚集在一起,探讨 API 领域的机会和挑战。APIStrat 在 API 提供者和 API 消费者、初创公司和企业、开发人员和架构师以及各种集成商之间引发了对话。

主旨演讲亮点:Virginia Eubanks

Virginia Eubanks 是纽约州立大学奥尔巴尼分校的政治学副教授。她是《自动化不平等:高科技工具如何对穷人进行画像、管控和惩罚》、《数字死胡同:为信息时代中的社会正义而战》一书的作者;以及与 Alethia Jones 合著的《绝不会让任何人改变我:与芭芭拉·史密斯一起建设运动 40 年》一书的合编者。她关于科技和社会正义的著作发表在《美国展望》、《民族》、《哈珀》和《连线》等杂志上。二十年来,Eubanks 一直致力于社区科技和经济正义运动。今天,她是“我们的数据之躯”项目的发起人,也是新美国基金会的成员。她住在纽约州特洛伊。

 

 

 

立即注册

无论您的企业是使用 API 还是生成 API,此次会议都是与推动 API 实施发展前沿的公司和开发人员互动的最佳机会。

期待在纳什维尔与您相见

在 APIStrat 2018 加入 Kate O’Neill

作者 博客

加入 OpenAPI Initiative 以及数百名 API 开发人员、策略师和思想领袖,参加 APIStrat 2018,活动将于 9 月 24 日至 26 日在音乐之城举行。

APIStrat 将 API 爱好者与今天的领导者聚集在一起,探讨 API 领域的机会和挑战。APIStrat 在 API 提供者和 API 消费者、初创公司和企业、开发人员和架构师以及各种集成商之间引发了对话。

主旨演讲亮点:Kate O’Neill

凯特·奥尼尔,被称为“技术人文主义者”,是 KO Insights 的创始人兼首席执行官。 KO Insights 是一家屡获殊荣的思想领导力和咨询公司,帮助企业、组织和城市基于人类行为和数据做出与未来一致的、有意义的决策。凯特是包括《像素与场所:连接物理和数字空间中的人类体验》在内的三本书的作者,她经常在行业会议和私人活动上发言,进行主题演讲,参与小组讨论,并为各种规模的团队主持创意头脑风暴研讨会。她的专业知识已在 CNN Money、时代周刊、福布斯、今日美国、男士杂志、英国广播公司以及其他国家和国际媒体中被报道。凯特之前的角色包括在 Netflix 创建第一个内容管理职位,领导 Magazines.com 的前沿在线优化工作,开发东芝美国的第一个内部网,建立伊利诺伊大学芝加哥分校的第一个部门网站,并在各种数字内容和科技初创公司担任领导职位。她也是 [meta]marketer 的创始人兼首席执行官,这是一家数字策略和分析机构。凯特是科技、创业和领导力领域女性的积极倡导者,她被 Google 特别选入其为女性创业者举办的全球宣传活动的启动仪式。

立即注册

无论您的企业是使用 API 还是生成 API,此次会议都是与推动 API 实施发展前沿的公司和开发人员互动的最佳机会。

期待在纳什维尔与您相见