OpenAPI

OpenAPI 是一种用于描述 RESTful API 的接口规范，原为 Swagger 规范，2016 年由 SmartBear 捐赠给 Linux 基金会旗下的 OpenAPI Initiative（OAI）。其核心以 JSON 或 YAML 格式定义 API 的路径、请求/响应结构、参数和认证方式，具有机器可读、语言无关的特点。主要用途包括 API 文档自动生成、客户端 SDK 生成、接口测试和服务模拟。OpenAPI 3.0 于 2017 年发布，3.1 版于 2021 年发布，引入了 JSON Schema 2019-09 兼容性等改进。该规范已被业界广泛接受，成为构建可互操作的 HTTP API 的事实标准。