Dal corso: Fondamenti di programmazione: API e servizi web

Sblocca questo corso con una prova gratuita

Iscriviti adesso per accedere a oltre 23.100 corsi tenuti da esperti del settore.

Documentare un'API

Documentare un'API

- [Istruttore] Parliamo di documentare un'API. Quello che vedremo è molto utile per gli sviluppatori e gli ingegneri del software che hanno bisogno di consumare o utilizzare un servizio web esistente nelle loro applicazioni. Swagger è lo strumento di scelta per documentare un'API ed è uno strumento che ti consente di capire come funziona un'API. Quando si crea un'API REST, una buona documentazione è strumentale e anche mantenere tale documentazione aggiornata ad ogni nuova modifica è strumentale. Realizzare questo manualmente è un esercizio noioso. Quindi l'automazione, tramite Swagger, fa risparmiare tempo. E quindi questo è solo un esempio dall'esempio swagger petstore che mostra l'API e tutte le diverse funzionalità e operazioni su di essa. Ora di più su Swagger. Swagger è un insieme di strumenti open source costruiti attorno alla specifica OpenAPI e sto mostrando la specifica qui. Quindi questa specifica definisce uno standard ed è indipendente dal linguaggio di programmazione…

Contenuti