Documentare le API con Swagger

In questi giorni ho avuto modo di confrontarmi con Nicolò Carandini sul tema Swagger, un metalinguaggio utile per documentare le API esposte da servizi REST.

Mi è sembrata un’ottima soluzione, visto che oltre ad avere interessanti automatismi ci consente, con relativamente poco sforzo, di avere sempre una documentazione “up-to-date” e di ridurre al minimo il lavoro necessario per adempiere a queste necessità.

avatar99

Quindi, se avete una necessità del genere, vi consiglio di ascoltare il podcast che ne abbiamo prodotto, e di approfondire poi l’argomento tramite i link presenti nella pagina.

Documentare le API con Swagger

Lascia un commento

Inserisci i tuoi dati qui sotto o clicca su un'icona per effettuare l'accesso:

Logo WordPress.com

Stai commentando usando il tuo account WordPress.com. Chiudi sessione / Modifica )

Foto Twitter

Stai commentando usando il tuo account Twitter. Chiudi sessione / Modifica )

Foto di Facebook

Stai commentando usando il tuo account Facebook. Chiudi sessione / Modifica )

Google+ photo

Stai commentando usando il tuo account Google+. Chiudi sessione / Modifica )

Connessione a %s...