AAsteriadne

website

OpenAPI Initiative

所属分类：开发者在线工具箱

OpenAPI 规范的官方发布站与社区参与入口

代码文档

OpenAPI Initiative 是维护 OpenAPI 规范的开放社区，官网提供规范发布入口、治理文件和参与方式。首页的主要入口是最新版 OpenAPI 规范（OAS）、Arazzo 规范和 Overlay 规范，适合需要用标准格式描述 HTTP API 的开发者。

OpenAPI Initiative：查阅 OpenAPI 规范并参与实现反馈

发布于 2026年10月18日更新于 2026年10月30日

首页的规范入口

首页标题称 OpenAPI 为“世界上使用最广泛的 API 描述标准”，并提供 All OpenAPI Publications、How to Get Involved 两个入口，以及 View Latest OpenAPI Spec、View Latest Arazzo Spec 和 View New Overlays Spec 三个规范按钮。顶部的 Specifications 菜单下列出 OpenAPI Publications、最新规范、Registries 等项目，另有一个指向 OAI 规范学习站点的链接。

OpenAPI Initiative 官网首页，标题为“The world's most widely used API description standard”，下方有查看最新规范与 Arazzo、Overlay 规范的按钮

规范正文的范围

最新版规范页面的标题为 OpenAPI Specification v3.2.1，注明发布于 2026 年 9 月 10 日。正文开头说明，OpenAPI 规范以与编程语言无关的方式描述 HTTP API，人和计算机都能在不读源码、不抓取网络流量的情况下了解服务的能力。目录从 Introduction 开始，其中“Versions and Deprecation”一节说明版本与弃用的规则。

页面底部列出了 3.2.0、3.1.2、3.1.1、3.1.0、3.0.4 至 3.0.0 以及 2.0 等历史版本的链接，方便核对某个项目采用的规范版本。

参与方式与社区

Participate 栏目包括 How To Contribute、通过 GitHub 参与的说明、加入 Slack 的入口以及社区日历。Governance 栏目列出 Project Charter、技术指导委员会（Technical Steering Committee）、技术监督委员会（Technical Oversight Board）和行为准则。Membership 栏目列出现有成员、会员说明和加入入口。

“分享你的 OAS 实现”页面面向实现者。页面称，技术开发者社区希望了解用户如何使用 OAS、希望看到哪些更新，以及规范遗漏了什么，并附有填写表单。

OpenAPI Initiative“分享你的 OAS 实现”页面的表单，第一题为 How are you using the OpenAPI Specification v3?，下方是项目名称与项目类型选项