跳至主要内容
类别

博客

OAI 更新 - 新成员、OpenAPI Spec 3.0 进度等!

作者 博客

以下是 OAI 最新进展的简要更新。

新成员

越来越多的公司对加入 OAI 感兴趣,我们很高兴欢迎两家新成员加入。

  • Apiary: 最近宣布支持 Swagger/OpenAPI Spec 的 API 设计和协作工具创建者。
  • Atlassian: JIRA、Confluence、HipChat、Bamboo 等背后的公司。

如果您所在的组织有兴趣加入 OAI,以支持 OpenAPI 规范的演进和普及,请访问 https://www.openapis.org.cn/join 查看如何加入的详细信息。

技术开发者社区的初始会员资格和流程已确定

推动 OpenAPI 规范的技术开发者社区的初始成员已确定;

此贡献者列表在 GitHub 上 保持更新,符合 OAI 章程。

TDC 发布了 https://github.com/OAI/OpenAPI-Specification/blob/OpenAPI.next/DEVELOPMENT.md 的规范演进流程。

OpenAPI Spec 3.0 工作进展

下一代规范的开发工作已经开始,有关各种功能/改进的讨论正在 GitHub 上的相关问题中进行。如果您有兴趣了解或参与,以下是一些链接,可以为您指明方向。

OAI 在活动中亮相

OAI 的成员将在欧洲即将举行的两场 OW2 活动中代表 OAI。

OAI 目前正在评估其参与全球即将举行的 API 相关活动的可能性;如果您正在组织希望 OAI 出席的活动,或者您有兴趣组织 OAI 可以赞助的本地 OAI/OpenAPISpec 会议,请随时 联系我们

其他正在进行的活动

  • 我们已经指定了一个内部工作组,为 OAI 徽标和标记的使用提供指南 - 这些指南将在我们的网站上发布。
  • OpenAPI 规范现在有了一个 https://twitter.com/openapispec 的 Twitter 帐户 - 关注它,即可获悉与 OAI 和 OpenAPI-Spec 相关的新闻。

目前就这些 - 如果您有兴趣参与有关 OpenAPI 规范的技术讨论,请随时联系 GitHub 上的 TDC,如果您有任何一般性问题,请通过我们的 联系表格 联系 OAI 成员 - 我们期待您的来信。

/Ole Lensmar
@olensmar

OAI 的下一步计划 - 激动人心的 2016 年即将到来!

作者 博客

在年末各项活动如火如荼进行的同时,OAI 也在为 2016 年做好准备。去年 12 月,我们在小组内部举行了几次会议,取得了以下成果。

1. OADF 更名为“OpenAPI 规范”

最初建议的规范名称为 OADF(“Open API Definition Format”) - 这个名字似乎急需用更吸引人的名字来代替;OAI 的成员决定将“OpenAPI 规范”(缩写为“OAS”)作为未来使用的正式名称。

2. Swagger 规范存储库已移至 GitHub 上的 OAI

因此,Swagger 2.0 规范存储库已从其在 GitHub 上的 swagger-api 组织下的原始位置迁移到新的 OAI 组织,名称为“OpenAPI 规范” - https://github.com/OAI/OpenAPI-Specification

目前规范本身尚未更改,以免影响与 Swagger 2.0 定义配合使用的现有工具。OAS 的下一个版本将弃用规范中任何使用“swagger”一词的地方,转而使用 OAS 特定的术语;TDC 将负责实施这一过渡。

OAS 将继续在 Apache 2.0 许可下授权。

3. OAI 新成员

OAI 初次发布后,加入 OAI 的热情高涨,我们很高兴欢迎以下公司加入。

如果您或您的组织有兴趣加入 OAI,请随时通过 https://www.openapis.org.cn/join 联系 OAI。

4. OAI 新领导层正在形成

OAI 章程指定了三个构成其管理结构的实体。

  1. 成员委员会负责制定整个小组的章程,并管理非技术性任务。
  2. 技术开发者委员会 (TDC) 负责 OAS 的技术演进工作。
  3. 技术监督委员会 (TOB) 负责解决 TDC 中的任何冲突,并确保 TDC 按照 OAI 的核心价值观交付成果。

TDC 和 TOB 的组成仍在进行中;目前,已经选出了以下人员。

  • TDC 成员:
  • TOB 成员
    • 由 OAI 成员选举:Tony Tam、Ron Ratovsky、Jason Harmon
    • 由 TDC 成员选举:
  • OAI 主席:Ole Lensmar

下一步计划

随着 OAI 开始成形,我们有以下议程。

  • 完成 TDC 和 TOB 的成员资格
  • 在 TDC 内开始下一个版本 OAS 的开发工作
  • 决定 OAI 可以参与哪些非技术活动,以促进 OAS 的进一步演进及其在行业中的应用

我当然对未来充满期待 - API 背后的行业势头丝毫没有减弱,而对于 API 定义的通用语言的需求也越来越明显,因为企业正在努力最大限度地利用 API 为最终用户提供价值。

新年快乐!

/Ole Lensmar