OpenAPI規格
 | 此條目翻譯品質不佳。 (2024年9月26日) |
| OpenAPI Specification | |
| 开始年 | 2010年 |
|---|---|
| 首次出版 | 2011年8月10日 |
| 最新版本 | 3.1.0 2021年2月15日 |
| 网站 | openapis |
 | 此條目可参照英語維基百科相應條目来扩充。 (2024年9月26日) |
OpenAPI規格（英語：OpenAPI Specification, OAS），原稱Swagger規格，是種机器可读的接口描述语言規格以描述、生成、使用和可视化Web服务。 [1] 原先，是Swagger框架的一部分，2015年成为独立项目，由Linux基金会的开源合作项目OpenAPI Initiative监督。 [2] [3]
OpenAPI 描述 (OAD) [4]表示 API 的正式描述，機器可以依此生成代码、文档、测试用例等。OpenAPI 计划每年赞助一次 API 規格会议 (ASC)。该活动起源于举办多年的 API 战略与实践会议 (APIStrat)，并于 2016 年成为 OpenAPI 计划的一部分。
历史
[编辑]2010年初，在线词典公司Wordnik工作的Tony Tam開發Swagger。 [5]
2015年3月， SmartBear Software自Wordnik 的母公司 Reverb Technologies手上收购开源的Swagger API規格。 [6]
2015年11月，SmartBear将Swagger 規格捐献给Linux基金会赞助的OpenAPI Initiative。其他创始成员包括3scale、Apigee、第一資本、Google、IBM、Intuit、微軟、PayPal和Restlet。[7][8]
2016年1月1日，Swagger規格更名为OpenAPI規格（OAS），并移至新的GitHub目錄。 [9]
2017年7月，OpenAPI 计划发布了規格的 3.0.0 版本。 [10] MuleSoft是替代RESTful API 建模语言(RAML) 的主要贡献者，加入OpenAPI規格，开源其API建模框架工具。該工具可以將RAML输入轉換生成OAS文档。 [11]
发布日期
[编辑]| 版本 | 日期 | 注释[12] |
|---|---|---|
| 3.1.0 | 2021-02-15 | OpenAPI 規格 3.1.0 发布 |
| 3.0.3 | 2020-02-20 | OpenAPI 規格 3.0.3 补丁版本 |
| 3.0.2 | 2018-10-08 | OpenAPI 規格 3.0.2 补丁版本 |
| 3.0.1 | 2017-12-06 | OpenAPI 規格 3.0.1 补丁版本 |
| 3.0.0 | 2017-07-26 | OpenAPI 規格 3.0.0 发布 |
| 2.0 | 2014-09-08 | Swagger 2.0 发布 |
| 1.2 | 2014-03-14 | 正式文件的首次发布 |
| 1.1 | 2012-08-22 | Swagger 1.1 发布 |
| 1.0 | 2011-08-10 | Swagger 規格的首個版本 |
特征
[编辑]OpenAPI 規格与语言无关。借助 OpenAPI 的宣告式资源規格，客户端无需了解服务器实现或访问服务器代码即可理解和使用服务。 [1]
参见
[编辑]参考
[编辑]- ^ 1.0 1.1 OpenAPI Documentation: Getting Started. Learn OpenAPI. The OpenAPI Initiative. [2024-09-17].
- ^ New Collaborative Project to Extend Swagger Specification for Building Connected Applications and Services. （原始内容存档于31 October 2023）.
- ^ OpenAPI Initiative Charter. OpenAPI Initiative. [12 November 2019].
- ^ OpenAPI Documentation: Glossary. Learn OpenAPI. The OpenAPI Initiative. 2023 [2024-09-17].
- ^ Swagger creator joins SmartBear. [August 6, 2019].
- ^ SmartBear Assumes Sponsorship of Swagger API Open Source Project. SmartBear. [2015-03-25].
- ^ FAQ. OpenAPI Initiative. [12 November 2019].
- ^ New Collaborative Project to Extend Swagger Specification for Building Connected Applications and Services. linuxfoundation.org. [2016-04-22]. （原始内容存档于2016-04-27）.
- ^ OpenAPI Initiative. OpenAPI Specification. GitHub. [12 November 2019].
- ^ The OAI Announces the OpenAPI Specification 3.0.0. OpenAPIs. July 26, 2017 [2018-04-19].
- ^ Avram, Abel. The HTTP API space is Consolidating around OAS. InfoQ. May 6, 2017 [2017-05-14].
- ^ OpenAPI Specification Version 3.1.0. GitHub. [November 7, 2023].