Tutorial sulla documentazione Swagger API per principianti - Parte 1: Introduzione alla documentazione API con Swagger

Cos’è Swagger?

Lo scopo di Swagger™ è definire uno standard di interfaccia indipendente dal linguaggio per le API REST, che permette sia agli esseri umani che ai computer di scoprire e comprendere le funzionalità di un servizio senza bisogno di accedere al codice sorgente, alla documentazione o di analizzare il traffico di rete. Quando un’API è correttamente definita tramite Swagger, un utente può capirne il funzionamento e interagirvi con pochissimo codice di implementazione. Proprio come le interfacce hanno semplificato la programmazione a basso livello, Swagger elimina le incertezze nell’utilizzo del servizio.

Tecnicamente parlando, Swagger è una specifica formale circondata da un vasto ecosistema di strumenti, che include interfacce utente front-end, librerie di codice a basso livello e soluzioni commerciali per la gestione delle API.

Come iniziare?

Se sei un fornitore di API e vuoi usare Swagger per descrivere le tue API, ci sono diversi approcci disponibili:

Un approccio *top-down*, dove puoi usare lo Swagger Editor per creare la definizione Swagger e poi utilizzare gli strumenti integrati di Swagger Codegen per generare l’implementazione del server.
Se