Especificació OpenAPI
L'Especificació OpenAPI, coneguda anteriorment com a Swagger Specification, és una especificació per a fitxers d'interfície llegibles per màquina per descriure, produir, consumir i visualitzar serveis web RESTful.[1] Anteriorment formava part del marc Swagger, es va convertir en un projecte independent el 2016, supervisat per OpenAPI Initiative, un projecte de col·laboració de codi obert de la Linux Foundation.[2] Swagger i algunes altres eines poden generar codi, documentació i casos de prova amb un fitxer d'interfície.
El desenvolupament de Swagger va començar a principis de 2010 per Tony Tam, que treballava a l'empresa de diccionaris en línia Wordnik.[3] Després d'una xerrada de trobada amb Kin Lane (comitè de direcció d'OpenAPI) i Tony Tam el 12 de juny de 2014,[4] Kin Lane es va acostar a Owen Rubel, que estava treballant en un enfocament similar i va agafar les seves idees per a la nova especificació Swagger 2.0 (que finalment seria convertir-se en OpenAPI).[5]
El març de 2015, SmartBear Software va adquirir l'especificació de l'API Swagger de codi obert de Reverb Technologies, l'empresa matriu de Wordnik.[6]
El novembre de 2015, SmartBear va anunciar que estava creant una nova organització anomenada OpenAPI Initiative sota el patrocini de la Linux Foundation. Altres empreses membres fundadors van incloure 3scale, Apigee, Capital One, Google, IBM, Intuit, Microsoft, PayPal i Restlet.[7][8][9] SmartBear va donar l'especificació Swagger al nou grup. RAML i API Blueprint també estaven sota consideració.[10][11]El febrer de 2021, OpenAPI Initiative va llançar la versió 3.1.0.[12] Els canvis principals a l'especificació OpenAPI 3.1.0 inclouen l'alineació de vocabularis de l'esquema JSON, un nou element de nivell superior per descriure els webhooks registrats i gestionats fora de banda, suport per identificar llicències d'API mitjançant l'identificador estàndard SPDX, permetre descripcions juntament amb l'ús d'esquemes, referències, i l'objecte PathItems ara és opcional per facilitar la creació de biblioteques reutilitzables de components.[13][14]
Referències[modifica]
- ↑ «Linux Foundation wants to extend Swagger in connected buildings | Business Cloud News». Arxivat de l'original el 6 maig 2016. [Consulta: 22 abril 2016].
- ↑ «OpenAPI Initiative Charter» (en anglès). OpenAPI Initiative. https://www.openapis.org.+[Consulta: 12 novembre 2019].
- ↑ «Swagger creator joins SmartBear» (en anglès). https://sdtimes.com.+[Consulta: 6 agost 2019].
- ↑ «API Design Panel» (en anglès). https://www.flickr.com.+[Consulta: 6 agost 2019].
- ↑ «Kin Lane Confesses To Borrowing OpenAPI ideas from separate project» (en anglès). https://www.flickr.com.+[Consulta: 6 agost 2019].
- ↑ «SmartBear Assumes Sponsorship of Swagger API Open Source Project» (en anglès). SmartBear. https://smartbear.com.+[Consulta: 25 març 2015].
- ↑ «FAQ» (en anglès). OpenAPI Initiative. https://www.openapis.org/.+[Consulta: 12 novembre 2019].
- ↑ «SmartBear, Linux Foundation launch Open API Initiative to Evolve Swagger». ProgrammableWeb, 10-11-2015. Arxivat 2016-11-09 a Wayback Machine.
- ↑ «New Collaborative Project to Extend Swagger Specification for Building Connected Applications and Services» (en anglès). www.linuxfoundation.org. http://www.linuxfoundation.org.+Arxivat de l'original el 2016-04-27. [Consulta: 22 abril 2016].
- ↑ Montcheuil, Yves de. «In 2016, the need for an API meta-language will crystallize» (en anglès). InfoWorld. http://www.infoworld.com.+[Consulta: 25 abril 2016].
- ↑ «Amazon API Gateway Now Supports Swagger Definition Import» (en anglès). InfoQ. http://www.infoq.com.+[Consulta: 25 abril 2016].
- ↑ «OpenAPI Specification 3.1.0 Available Now» (en anglès). Linux.com. https://www.linux.com.+[Consulta: 26 abril 2021].
- ↑ «What’s New in OpenAPI 3.1.0?» (en anglès). Nordic APIs. https://nordicapis.com.+[Consulta: 7 abril 2021].
- ↑ «OpenAPI Specification 3.1.0 Released» (en anglès). OpenAPI Initiative. https://www.openapis.org.+[Consulta: 18 febrer 2021].