RESTful API
RESTful API 是一种 API 设计风格,遵循 REST(Representational State Transfer)架构原则。
RESTful API 定义了一组用于与 Web 资源交互的规则和约束,例如使用 HTTP 方法、资源 URI 等。
Swagger
Swagger 是一个用于描述和文档化 RESTful API 的开源框架。
Swagger 提供了一种简单直观的方式来描述、生成、使用和可视化 RESTful API。
Swagger 使用一种特定的 JSON 或 YAML 文件格式来定义 API 的结构和行为。
OpenAPI 规范
OpenAPI 规范(以前称为 Swagger 规范)是一种用于描述 RESTful API 的行业标准。
OpenAPI 规范定义了一种标准的、语言中立的接口描述格式,用于描述 RESTful API 的整体结构。
Swagger 工具就是基于 OpenAPI 规范来实现的。
Swagger RESTful API OpenAPI三者之间的关系
总的来说,Swagger 是一个基于 OpenAPI 规范的框架,用于方便地描述和文档化 RESTful API。OpenAPI 规范定义了 API 描述的标准格式,而 Swagger 提供了一整套工具和库来实现 OpenAPI 规范。两者相辅相成,共同推动了 RESTful API 的发展和标准化。