Specifiche OpenAPI: differenze tra le versioni
Contenuto cancellato Contenuto aggiunto
No2 (discussione | contributi) m Corretto il collegamento Api con Application programming interface (DisamAssist) |
Funzionalità collegamenti suggeriti: 3 collegamenti inseriti. Etichette: Modifica visuale Modifica da mobile Modifica da web per mobile Attività per i nuovi utenti Suggerito: aggiungi collegamenti |
||
Riga 4:
==Uso==
Le applicazioni implementate basandosi su file di interfaccia OpenAPI possono automaticamente generare la documentazione di metodi, parametri e modelli. Questo aiuta a sincronizzare la documentazione, le librerie [[client]] e il codice sorgente.
==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 a inizio 2010.<ref name=git>{{Cita web|titolo= swagger-api/swagger-spec|url= https://github.com/swagger-api/swagger-spec/wiki|sito= GitHub|accesso= 1º dicembre 2015}}</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 OpenAPI Initiative. Una serie di società, incluse [[Google]], [[IBM]] e [[Microsoft]] sono soci fondatori.<ref>{{Cita news|url=http://www.programmableweb.com/news/%E2%80%8Bsmartbear-linux-foundation-launch-open-api-initiative-to-evolve-swagger/2015/11/10|titolo=SmartBear, Linux Foundation launch Open API Initiative to Evolve Swagger|cognome=|nome=|data=10 novembre 2015|pubblicazione=ProgrammableWeb|accesso=21 aprile 2016|dataarchivio=9 novembre 2016|urlarchivio=https://web.archive.org/web/20161109214454/http://www.programmableweb.com/news/%E2%80%8Bsmartbear-linux-foundation-launch-open-api-initiative-to-evolve-swagger/2015/11/10|urlmorto=sì}}</ref><ref>{{Cita web|url=https://www.linuxfoundation.org/news-media/announcements/2015/11/new-collaborative-project-extend-swagger-specification-building|titolo=New Collaborative Project to Extend Swagger Specification for Building Connected Applications and Services|accesso=22 aprile 2016|urlmorto=sì|urlarchivio=https://web.archive.org/web/20160427104213/http://www.linuxfoundation.org/news-media/announcements/2015/11/new-collaborative-project-extend-swagger-specification-building|dataarchivio=27 aprile 2016}}</ref> Nello stesso anno Swagger ha donato la specifica Swagger 2.0 al nuovo gruppo OpenAPI Initiative<ref>{{Cita web|url=https://spec.openapis.org/oas/v3.1.0#appendix-a-revision-history|titolo=OpenAPI Specification v3.1.0 {{!}} Introduction, Definitions, & More|sito=spec.openapis.org|accesso=2024-03-25}}</ref>. Anche RAML e API Blueprint sono in esame da parte del gruppo.<ref>{{Cita web|url=http://www.infoworld.com/article/3014506/apis/in-2016-the-need-for-an-api-meta-language-will-crystallize.html|titolo=In 2016, the need for an API meta-language will crystallize|cognome=Montcheuil|nome=Yves de|sito=InfoWorld|accesso=25 aprile 2016}}</ref><ref>{{Cita web|url=http://www.infoq.com/news/2016/04/Amazon-API-Gateway-Swagger|titolo=Amazon API Gateway Now Supports Swagger Definition Import|sito=InfoQ|accesso=25 aprile 2016}}</ref>
Riga 18:
Questo standard viene utilizzato per descrivere un'interfaccia in modo agnostico rispetto al [[linguaggio di programmazione]] utilizzato. In tal modo essa consente alle macchine e agli esseri umani di comprendere le caratteristiche di un servizio anche senza avere l'accesso al [[codice sorgente]].<ref>{{Cita web|url=https://spec.openapis.org/oas/v3.1.0|titolo=OpenAPI Specification v3.1.0 {{!}} Introduction, Definitions, & More|sito=spec.openapis.org|accesso=2024-03-25}}</ref>
Il framework UI Swagger permette sia a sviluppatori sia a non-sviluppatori di interagire con la API in una sandbox UI che offre una chiara intuizione di come la API risponde ai parametri e alle opzioni. Swagger può utilizzare sia JSON sia [[YAML]].<ref name=git />
==Note==
| |||