查看“︁OpenAPI”︁的源代码

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