Specifiche OpenAPI: differenze tra le versioni
Contenuto cancellato Contenuto aggiunto
→Collegamenti esterni: Sostituito il collegamento al sito ufficiale e quello alla relativa pagina delle specifiche su GitHub con il template "Collegamenti esterni" in quanto sono già presenti su Wikidata Etichette: Modifica da mobile Modifica da applicazione mobile Modifica da applicazione Android App section source |
m Bot: numeri di pagina nei template citazione |
||
| (2 versioni intermedie di 2 utenti non mostrate) | |||
Riga 4:
== Uso ==
Le applicazioni implementate, basandosi su file di interfaccia OpenAPI, possono generare automaticamente la documentazione dei metodi, dei parametri e dei modelli. Questo aiuta a sincronizzare la documentazione, le librerie [[client]] e il [[codice sorgente]].
== Storia ==
Riga 11:
Nel novembre 2015, SmartBear, la società che ha sostenuto Swagger, ha annunciato che stava contribuendo alla creazione di 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|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>
Il 1
Il 26 luglio 2017, l'OpenAPI Initiative ha rilasciato la versione 3.0.0 della specifica.<ref>{{Cita web|url=https://www.openapis.org/blog/2017/07/26/the-oai-announces-the-openapi-specification-3-0-0|titolo=The OAI Announces the OpenAPI Specification 3.0.0|autore=OpenAPI Initiative|sito=OpenAPI Initiative|data=2017-07-26|lingua=en-US|accesso=2024-10-13}}</ref> Tra le novità possiamo notare una semplificazione della struttura, con maggiore riutilizzabilità dei componenti; un miglioramento delle definizioni di sicurezza, inclusa la rinominazione dei flussi [[OAuth]] 2 per corrispondere alla specifica OAuth2; l'aggiunta delle [[callback]] e dei link.<ref>{{Cita web|url=https://swagger.io/blog/news/whats-new-in-openapi-3-0/|titolo=What is OpenAPI 3.0? {{!}} Swagger Blog|sito=SmartBear.com|accesso=2024-10-13}}</ref>
Riga 18:
== Caratteristiche ==
La specifica OpenAPI non richiede un [[linguaggio di programmazione]] specifico. Inoltre, è estendibile per l'uso con nuove tecnologie e protocolli. Gli strumenti OpenAPI sono generalmente compatibili con le specifiche RESTful e descrivono come un'API è organizzata e come interagisce con gli utenti, facendo uso di strumenti come Swagger UI, Swagger Codegen, Swagger Hub e Swagger Editor. L'architettura di base della specifica si concentra su tre componenti principali:
* Descrizione di un'API
Riga 38:
==Bibliografia==
*{{Cita conferenza| doi = 10.1109/ICWS.2014.30|titolo= A Model-Driven Approach for REST Compliant Services|collana= 2014 IEEE International Conference on Web Services|conferenza= [[International Conference on Web Services|ICWS]] 2014|pp=
==Voci correlate==
| |||