OpenAPI规格
此条目翻译品质不佳。 (2024年9月26日) |
OpenAPI规格(英语:OpenAPI Specification, OAS),原称Swagger规格,是种机器可读的接口描述语言规格以描述、生成、使用和可视化Web服务。 [1] 原先,是Swagger框架的一部分,2015年成为独立项目,由Linux基金会的开源合作项目OpenAPI Initiative监督。 [2] [3]
OpenAPI Specification | |
开始年 | 2010年 |
---|---|
首次出版 | 2011年8月10日 |
最新版本 | 3.1.0 2021年2月15日 |
网站 | openapis |
此条目可参照英语维基百科相应条目来扩充。 (2024年9月26日) |
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].