Versione delle 11:20, 7 mar 2024 modifica Sisittu99 (discussione \| contributi) 782 modifiche Nessun oggetto della modifica Etichetta: Modifica visuale ← Differenza precedente		Versione delle 23:45, 25 mar 2024 modifica annulla Pietrantonio91 (discussione \| contributi) 111 modifiche Ho cercato di migliorare e arricchire il contenuto della voce (con note annesse). Ho aggiunto alcuni collegamenti ad altre pagine. Rimangono comunque delle frasi che non sono chiare o non hanno una fonte specificata Etichette: Modifica visuale Link a pagina di disambiguazione Attività per i nuovi utenti Newcomer task: copyedit Differenza successiva →
Riga 1: {{Correggere\|informatica\|marzo 2024\|Traduzione frettolosa}}{{Aggiornare\|anno=2016\|argomento=informatica}} La '''Specifica OpenAPI''' (~~conosciuta~~ originariamente nota 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>{{Cita web\|url=http://www.businesscloudnews.com/2015/11/06/linux-foundation-wants-to-extend-swagger-in-connected-buildings/\|titolo=Linux Foundation wants to extend Swagger in connected buildings {{!}} Business Cloud News\|accesso=22 aprile 2016\|dataarchivio=20 luglio 2018\|urlarchivio=https://web.archive.org/web/20180720165819/http://www.businesscloudnews.com/2015/11/06/linux-foundation-wants-to-extend-swagger-in-connected-buildings/\|urlmorto=sì}}</ref> ~~Una~~Un ~~serie~~documento OpenAPI rappresenta una descrizione formale di ~~strumenti~~un'[[API]] che può essere utilizzata da diversi strumenti per generare codice, documentazione, e ''[[test case]]'' ~~dato~~e unaltro ~~file di interfaccia~~ancora. ==Uso== Riga 7: ==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 ada 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 ~~Open API~~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> Il 1 gennaio 2016 la specifica Swagger è stata rinominata la Specifica OpenAPI, ed è stata spostata in una nuova repository su [[GitHub]]. ==Caratteristiche== La Specifica OpenAPI non richiede un linguaggio specifico. Inoltre è estendibile su nuove tecnologie e protocolli oltre l'HTTP.<ref name=git /> 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> ~~Con la specifica dichiarativa delle risorse, i client possono comprendere e consumare servizi senza conoscere l'implementazione del server o accedere al codice del server.<ref name=git />~~ 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 />

Specifiche OpenAPI: differenze tra le versioni