OpenAPI Initiative

OpenAPI Initiative 今天宣布 Noname Security 已加入成为新成员。欢迎！

根据 Noname Security 委托进行的最新研究，《2022 年 API 安全趋势》，76% 的受访者报告称他们在过去 12 个月内遭遇过 API 安全事件。Noname 涵盖了三个支柱的 API 安全：态势管理、运行时安全和 API 安全测试。Noname Security 是一家私营公司，以远程优先方式运营，总部位于加利福尼亚州硅谷，并在特拉维夫和阿姆斯特丹设有办事处。

Noname 与 20% 的财富 500 强企业合作，并获得了众多安全奖项。

“随着我们继续快速增长，加入 OpenAPI Initiative 将带来巨大的价值，可以加强我们平台从态势管理到 API 安全测试的各个方面，”Noname Security 联合创始人兼首席技术官 Shay Levi 表示。“我们很高兴能成为 OpenAPI Initiative 的一部分，并期待通过支持这种供应商中立的开源规范和生态系统，更好地为我们的客户及其关键资产服务。”

要了解有关 Noname Security 的更多信息，请访问：https://nonamesecurity.com/  

想成为 OpenAPI Initiative 的成员？在这里找到更多信息：https://www.openapis.org.cn/membership/join 

OpenAPI 资源

要了解有关参与 OpenAPI 规范演进的更多信息：https://www.openapis.org.cn/participate/how-to-contribute

●   成为会员

●   OpenAPI 规范推特

●   OpenAPI 规范 GitHub – 立即开始！

●   分享您的 OpenAPI Spec v3 实现

关于 OpenAPI Initiative

OpenAPI Initiative (OAI) 由一群有远见的行业专家创建，他们认识到标准化 API 描述方式的巨大价值。作为 Linux 基金会下属的开放治理结构，OAI 专注于创建、发展和推广供应商中立的描述格式。OpenAPI 规范最初基于由 SmartBear Software 捐赠的 Swagger 规范。要参与 OpenAPI Initiative，请访问 https://www.openapis.org.cn

关于 Linux 基金会

Linux 基金会成立于 2000 年，拥有 1000 多个成员的支持，是全球领先的开源软件、开放标准、开放数据和开放硬件协作中心。Linux 基金会项目（如 Linux、Kubernetes、Node.js 等）被认为是全球最重要的基础设施发展至关重要。其开发方法利用了成熟的最佳实践，并满足了贡献者、用户和解决方案提供商的需求，以创建可持续的开放协作模式。有关更多信息，请访问 linuxfoundation.org。

今年由 OpenAPI Initiative 举办的 API 规范大会 (ASC) 创造了演讲提交数量的记录，赢得了 CHAOSS 金牌，表彰其在多样性和包容性方面的成就，95% 的与会者将其评为优秀或以上，并且是一次绝佳的社交机会，而且……非常有趣！

ASC 2022 于 9 月 19 日至 21 日在加州南旧金山举行。由于新冠疫情限制，作为预防措施，会议在过去两年中以线上方式举行。今年，它采用了混合形式。无论采用何种形式，会议都一直非常受欢迎，展示了开发人员、用户、公司、组织、API 工具制造商等，他们都对 API 技术感兴趣。

聆听行业专家讨论 OpenAPI 规范、RAML、Blueprint、gRPC、OData、JSON、Schema、GraphQL、AsyncAPI 和其他格式等主题，这真是令人兴奋。

录音可从 这里（现场）和 这里（虚拟）获取。

 Linux 基金会关于 ASC 2022 的完整报告，“透明度报告：API 规范大会 (ASC)，”（PDF）可供下载。

ASC 2022 连续第二年获得了 CHAOSS 金牌，这是一个 Linux 基金会项目！颁发 CHAOSS 金牌是因为 ASC 2022 满足了开源社区中促进健康多样性和包容性 (D&I) 实践的 80% 或更多的要求。

其他包容性举措包括：提供 现场 资源，例如静音室，如果需要一个禁止对话和互动的地方，哺乳室和儿童保育，以及特殊的沟通贴纸，以及其他功能，使该活动尽可能地便捷。

主题演讲涵盖了各种 API 主题，包括 Akita Software 首席执行官 Jean Yang 关于 近实时、自动生成的 API 规范，让乐趣和利润并存 的演讲；Mike Kistler 和 Mark Weitzel 关于 大规模构建 API：从 API 治理转向 API 管理 的演讲；Microsoft 的 回顾小组，由 Postman 的 Kin Lane 主持，包括 BetterCloud 的 Lorinda Brandon，包括 Microsoft 的 Gareth Jones、Kubeshop 的 Ole Lensmar、Salesforce 的 Tanya Vlahovic；以及 Twitter 的 Daniele Bernardi 关于 Twitter 中的规范 的演讲。

---

CFP 提交数量创历史新高！🔥

API 规范大会 (ASC) 2022 收到 111 个 CFP 提交，而 2021 年为 104 个，2020 年为 72 个，2019 年为 42 个。由同行评审员组成的团队接受了 44 个会议。SmartBear 的计划主席 Frank Kilcommins 与规划委员会一起仔细策划了内容和主题演讲阵容，为今年的活动带来了最相关的主题和演讲。

对于错过了会议或希望再次观看会议的人来说，主题演讲和会议录音可在 我们的 YouTube 频道 上获取。

在此下载 Linux 基金会关于 ASC 2022 的完整报告：“透明度报告：API 规范大会 (ASC)” （PDF）可供下载。

OpenAPI Initiative 持续快速增长，目前拥有 45 名成员，包括 Atlassian、彭博社、eBay、谷歌、IBM、微软、甲骨文、Postman、SAP、SmartBear 等。

旧金山 – 2022 年 10 月 18 日 – OpenAPI Initiative 是一个由前瞻性行业专家组成的联盟，专注于创建、发展和推广 OpenAPI 规范 (OAS)，OAS 是一种与供应商无关的开放描述格式，用于 RESTful API。今天，该组织宣布思科已加入成为新成员。

作为云原生开发、AI/ML、API 安全、连接性、可观察性、网络自动化等领域社区驱动的创新的催化剂，思科认为，在整个云中标准化 Web API 将为全球开源和云原生社区生态系统提供透明度和价值。思科看到了实施 OpenAPI 规范以应对云原生挑战、降低实施成本以及通过开源支持下一代梦想家的优势。

“构建良好的组件是交付强大的应用程序和平台的核心考虑因素，”思科开源主管 Stephen Augustus 说。“思科很高兴加入 OpenAPI Initiative 中备受尊敬的合作伙伴，共同推动创新，并更广泛地采用 OpenAPI 规范作为健壮、可互操作应用程序的基础组件。”

“我们很高兴欢迎思科加入 OpenAPI Initiative。思科积极参与许多开源和 Linux 基金会项目，因此这是水到渠成的事情，我们期待与他们更紧密地合作，共同构建 OpenAPI 规范，”OpenAPI Initiative 营销主席兼 Postman 的 API 生命周期集成专家 Kevin Swiber 说。“我们的会员资格对任何理解 API 标准化巨大价值并有兴趣发展和推广与供应商无关的描述格式的人开放。为什么不加入并立即开始？”

想要成为 OpenAPI Initiative 的成员？在此处了解更多信息： https://www.openapis.org.cn/membership/join 

OpenAPI 资源

要了解有关参与 OpenAPI 规范演进的更多信息：https://www.openapis.org.cn/participate/how-to-contribute

●   成为会员

●   OpenAPI 规范推特

●   OpenAPI 规范 GitHub – 立即开始！

●   分享您的 OpenAPI Spec v3 实现

关于思科开源

思科在开源和标准生态系统中有着悠久的历史，在云原生开发、AI/ML、API 安全、连接性、可观察性、网络自动化等领域拥有社区驱动的创新。要了解更多关于思科开源活动的信息：opensource.cisco.com 

关于 OpenAPI Initiative

OpenAPI Initiative (OAI) 由一群有远见的行业专家创建，他们认识到标准化 API 描述方式的巨大价值。作为 Linux 基金会下属的开放治理结构，OAI 专注于创建、发展和推广供应商中立的描述格式。OpenAPI 规范最初基于由 SmartBear Software 捐赠的 Swagger 规范。要参与 OpenAPI Initiative，请访问 https://www.openapis.org.cn

关于 Linux 基金会

Linux 基金会成立于 2000 年，拥有 1000 多名成员的支持，是全球领先的开源软件、开放标准、开放数据和开放硬件协作之家。Linux 基金会项目，例如 Linux、Kubernetes、Node.js 等，被认为对世界上最重要的基础设施的开发至关重要。其开发方法利用了既定的最佳实践，并满足了贡献者、用户和解决方案提供商的需求，以创建可持续的开放协作模式。有关详细信息，请访问 linuxfoundation.org。

加入我们在 9 月 19 日至 21 日在南旧金山举行的 API 规范大会 (ASC)！ASC 2022 是 API 从业人员聚在一起讨论 API 技术演变的场所。ASC 包括前沿技术主题演讲和会议，这些会议描绘了 API 的未来、深入的规范和标准讨论。 

该活动旨在高度互动，在整个研讨会和会议期间都有充足的讨论时间！ 

想要赞助 ASC 2022，但觉得预算不够？再想想吧！

社区合作伙伴赞助对 OpenAPI 会员免费，非会员则需支付 500 美元。（如果您想了解有关成为 OpenAPI Initiative 会员的更多信息，请点击此处。）这种合作关系是一个绝佳的机会，可以与 API 从业人员（包括 API 开发人员、API 运营团队、API 设计人员和企业架构师）直接联系。 

报名截止日期为 8 月 19 日。 

所有社区合作伙伴赞助商将从以下方面受益

• 在赞助商展示区的共享桌子上展示
• 徽标包含在“感谢我们的赞助商”主题演讲幻灯片中
• 徽标包含在“感谢我们的赞助商”博客文章中 
  • 将在活动开始前发布在 OpenAPI 博客上
• 在活动网站上获得认可（在活动首页上醒目地展示徽标）
• 会后数据报告：提供活动人口统计数据和有关活动表现的更多详细信息

成为赞助商！

OpenAPI Initiative 是一个由前瞻性行业专家组成的联盟，专注于发展和实施 OpenAPI 规范 (OAS)，该组织欢迎 APIIDA 成为新成员。

APIIDA 提供 API 管理平台，并为客户开发解决方案和产品，通过启用与技术无关的 API 管理来管理变更。APIIDA 解决方案将 API 与其运行时环境分离，并将它们调整为集中式策略，充当独立实体。这样做的目标是改善客户体验，并允许快速增长新的业务模式和产品。 

“我们很高兴能成为 OpenAPI Initiative 的一部分。广泛采用 OpenAPI 等标准为我们提供了稳定的基础，我们可以在此基础上进行构建。我们希望与 OpenAPI Initiative 的其他成员一起，扩大 OpenAPI 规范的覆盖范围和采用范围。这将有利于 APIIDA 客户，并且对于更广泛的 API 社区来说是正确的事情，”APIIDA 的首席技术官兼联合创始人 Markus Müller 说。“通过积极参与特别兴趣小组和指导委员会，我们希望回馈社区。”

该公司目前为 300 多家各种规模和广泛行业的组织提供服务。 

想要成为 OpenAPI Initiative 的成员？在此处了解更多信息 ！

APIIDA 资源

• APIIDA 主页
• APIIDA 资源 
• APIIDA 产品页面
• APIIDA Youtube
• APIIDA LinkedIn
• APIIDA Twitter

OpenAPI 资源

要了解有关参与 OpenAPI 规范演变的更多信息： 

https://www.openapis.org.cn/participate/how-to-contribute

• 成为会员
• OpenAPI 规范 Twitter
• OpenAPI 规范 GitHub – 立即开始！
• 分享您的 OpenAPI Spec v3 实现

关于 OpenAPI Initiative

OpenAPI Initiative (OAI) 由一群前瞻性行业专家创建，他们认识到标准化 API 描述方式的巨大价值。作为 Linux 基金会下的开放治理结构，OAI 专注于创建、发展和推广与供应商无关的描述格式。OpenAPI 规范最初基于 Swagger 规范，由 SmartBear Software 捐赠。要参与 OpenAPI Initiative，请访问 https://www.openapis.org.cn

关于 Linux 基金会

Linux 基金会成立于 2000 年，拥有 1000 多名成员的支持，是全球领先的开源软件、开放标准、开放数据和开放硬件协作之家。Linux 基金会项目，例如 Linux、Kubernetes、Node.js 等，被认为对世界上最重要的基础设施的开发至关重要。其开发方法利用了既定的最佳实践，并满足了贡献者、用户和解决方案提供商的需求，以创建可持续的开放协作模式。有关详细信息，请访问 linuxfoundation.org。

这篇文章由 Green Turtle 的绿色科技顾问 Phil Sturgeon 和 Protect Earth 主席撰写。如果您想捐赠给 Phil 的慈善机构，请查看 Protect Earth ，该机构正在以一次一个田地的方式重新造林英国。

OpenAPI v3.1.0 做出了一些重大改进，解决了诸如 JSON Schema 对象和 OpenAPI Schema 对象之间的细微差别之类的问题，并增加了对 Webhooks 的支持。

升级工具可能很棘手，但这应该比从 v2 跳到 v3.0 要容易得多。为了减轻工作量，我们为工具开发人员准备了一些方便的资源，提供测试用例、示例和一般指南。

首先，这些文章将从用户的角度展示 v3.0 和 v3.1 之间的区别

• OpenAPI 官方发布说明
• OpenAPI 博客：从 3.0 迁移到 3.1
• Nordic APIs 博客：OpenAPI v3.1.0 中的新功能

你需要支持所有功能吗？

其中一些内容更多地针对最终用户以及他们需要做什么，但工具供应商需要做什么呢？

对于像 webhooks 这样的新功能，你可以问问自己：这个工具是否需要支持 webhooks？如果是文档工具，很可能需要！如果该工具正在验证传入的网络请求到您的服务器，那么可能不需要。

一些工具采用了 3.1.0 支持的定义，即“3.1.0 文档在同一个工具中可以与 3.0.0 一样好地工作”，这是一个好的第一步。然后可以稍后添加对其他新关键字的支持。

我认为，让 3.1.0 文档在基本层面上 工作 比支持 3.1.0 中的每一个功能都更重要。随着你的发展，最终用户会为你创建他们最感兴趣的功能请求。

JSON Schema 整合

对于大部分其他更改，区别在于，不再使用与 JSON Schema 非常相似 的模式对象，OpenAPI Schema 对象现在实际上就是 JSON Schema。这里涉及一些技术细节，从技术上讲，OpenAPI Schema 定义了自己的 JSON Schema 词汇表，它扩展了主要的 JSON Schema 词汇表并增加了对 discriminator 的支持。由于 discriminator 在 3.1.0 中的使用被明确为仅仅是对现有 oneOf、anyOf、allOf 的“提示”或快捷方式，因此绝大多数工具可以安全地忽略它。

tl;dr：你可以使用任何有效的 JSON Schema 工具来处理 OpenAPI 中 schema: 对象的内容，这意味着许多工具可以逐步淘汰对手工制作的模式检查代码的依赖，并利用任何现有的 JSON Schema 工具 来代替。

例如，如果你维护的某个工具以前在 JavaScript 中手动验证 OpenAPI 模式，那么你可以考虑将它包装在一个 if ($version == "3.0") 语句中，使用旧的逻辑，弃用它，然后如果版本是 3.1，你可以利用强大的工具，如 AJV 或 HyperJump 来完成所有繁重的工作。这会立即让你的工具从它们为你完成的所有工作中获益，包括支持现代 JSON Schema / OAS3.1 关键字，例如 if/then/else。

这也意味着它们可以承担起随着 JSON Schema 成熟为稳定版本而产生的其他变化的重任（尽管如果你能帮助它们，那将是太棒了）。

测试用例

为了确保你的工具能够与 OpenAPI v3.1 协同工作，你需要一些 OpenAPI v3.1 文档来进行测试。目前还没有官方的 OpenAPI v3.1 文档列表，但社区编写了一些示例文件，可以用于测试套件，以展示成功或失败的场景

• Mermade OpenAPI v3.1 示例 – 极简的示例，涵盖了大多数新功能。
• Adyen OpenAPI – 一个金融科技平台，公开共享了真实的 OpenAPI v3.1 文档。

验证模式

许多工具使用一个 JSON Schema 文档来描述有效的 OpenAPI 文档。没错，这句话很元，但如果你知道我的意思，那么你一定想知道 OpenAPI v3.1 是否有新的文档？好消息是，有了！

• OpenAPI v3.1 官方模式

查找其他 v3.1 工具

要查看其他 OpenAPI 工具的进展情况，请查看 OpenAPI.Tools。也许有一些其他工具可以利用，或者一些开发者可以合作，或者可以向他们提问，或者可以雇佣他们来为你工作等等。

不要忘记向 OpenAPI.Tools 发送一个 pull 请求 ，说明你何时支持 v3.1，方法是在 _data/tools.yml 中添加 v3_1: true 。你也可以在 GitHub 上添加 openapi31 标签，这样其他工具聚合器也可以找到你！

• OpenAPI v3.1 工具开发人员资源
  • 你需要支持所有功能吗？
  • JSON Schema 整合
  • 测试用例
  • 验证模式
  • 查找其他 v3.1 工具

展开所有回到顶部转到底部