La '''Specifica OpenAPI''' (conosciuta originariamente come la Specifica Swagger) è una specifica per file di interfaccia leggibili dalle macchine per descrivere, produrre, consumare e visualizzare [[Web service|servizi web]] [[Representational State Transfer|RESTful]].<ref>{{CiteCita web|url=http://www.businesscloudnews.com/2015/11/06/linux-foundation-wants-to-extend-swagger-in-connected-buildings/|titletitolo=Linux Foundation wants to extend Swagger in connected buildings {{!}} Business Cloud News|access-dateaccesso=22 aprile 2016-04-22}}</ref> Una serie di strumenti può generare codice, documentazione e test case dato un file di interfaccia.
==Uso==
Riga 5:
==Storia==
Sia la specifica sia l'implementazione di un framework sono partite come iniziative da Wordnik. Swagger è stato sviluppato dall'uso di Wordnik durante lo sviluppo di Wordnik Developer e la sottostante API. Lo sviluppo di Swagger è partito ad inizio 2010.<ref>{{CiteCita web|title titolo= swagger-api/swagger-spec|url= https://github.com/swagger-api/swagger-spec/wiki|website sito= GitHub|accessdate accesso= 1º dicembre 2015-12-01}}</ref>
Nel novembre 2015 SmartBear, la società che ha sostenuto Swagger, ha annunciato che stava aiutando a creare una nuova organizzazione, sotto la sponsorizzazione della [[Linux Foundation]], chiamata Open API Initiative. Una serie di società, incluse [[Google]], [[IBM]] e [[Microsoft]] sono soci fondatori.<ref>{{CiteCita news|url=http://www.programmableweb.com/news/%E2%80%8Bsmartbear-linux-foundation-launch-open-api-initiative-to-evolve-swagger/2015/11/10|titletitolo=SmartBear, Linux Foundation launch Open API Initiative to Evolve Swagger|lastcognome=|firstnome=|datedata=10 novembre 2015-11-10|workpubblicazione=ProgrammableWeb|access-dateaccesso=21 aprile 2016-04-21|via=}}</ref><ref>{{CiteCita web|url=http://www.linuxfoundation.org/news-media/announcements/2015/11/new-collaborative-project-extend-swagger-specification-building|titletitolo=New Collaborative Project to Extend Swagger Specification for Building Connected Applications and Services|websitesito=www.linuxfoundation.org|access-dateaccesso=22 aprile 2016-04-22}}</ref> Swagger ha donato la specifica Swagger al nuovo gruppo. Anche RAML e API Blueprint sono in esame da parte del gruppo.<ref>{{CiteCita web|url=http://www.infoworld.com/article/3014506/apis/in-2016-the-need-for-an-api-meta-language-will-crystallize.html|titletitolo=In 2016, the need for an API meta-language will crystallize|lastcognome=Montcheuil|firstnome=Yves de|websitesito=InfoWorld|access-dateaccesso=25 aprile 2016-04-25}}</ref><ref>{{CiteCita web|url=http://www.infoq.com/news/2016/04/Amazon-API-Gateway-Swagger|titletitolo=Amazon API Gateway Now Supports Swagger Definition Import|websitesito=InfoQ|access-dateaccesso=25 aprile 2016-04-25}}</ref>
Il 1 gennaio 2016 la specifica Swagger è stata rinominata la Specifica OpenAPI, ed è stata spostata in una nuova repository su GitHub.
Riga 26:
==Bibliografia==
*{{Cite conferenceCita conferenza| doi = 10.1109/ICWS.2014.30| title titolo= A Model-Driven Approach for REST Compliant Services| work collana= 2014 IEEE International Conference on Web Services| conference conferenza= [[International Conference on Web Services|ICWS]] 2014| pages pp= 129–136| year anno= 2014| last1 cognome1= Haupt | first1 nome1= F. | last2 cognome2= Karastoyanova | first2 nome2= D. | last3 cognome3= Leymann | first3 nome3= F. | last4 cognome4= Schroth | first4 nome4= B. | isbn = 978-1-4799-5054-6}}
