# Creare API interoperabili, dove partire? **URL:** \ **Category:** Interoperabilità\ **Created:** [31 Maggio 2018, 11:29am UTC](https://forum.italia.it/t/creare-api-interoperabili-dove-partire/3491 "2018-05-31T11:29:27Z")\ **Posts on this page:** 4\ **Page:** 1
**Author:** ![Roberto\_Polli](https://forum.italia.it/user_avatar/forum.italia.it/roberto_polli/32/1127_2.png) [@Roberto\_Polli](https://forum.italia.it/u/Roberto_Polli)\ **Post date:** [31 Maggio 2018, 11:29am UTC](https://forum.italia.it/t/creare-api-interoperabili-dove-partire/3491/1 "2018-05-31T11:29:27Z")
Così vuoi creare un’API e non sai da dove iniziare. Qui trovi un [api-starter-kit](https://github.com/teamdigitale/api-starter-kit) che, partendo da un openapi-v3: - descrive un microservizo che ritorna un timestamp in formato RFC5424 - genera un server stub in python - serve il microservizio in https Sappiamo che molti generatori di codice supportano solo le vecchie specifiche swagger-2. Che fare allora? - innanzitutto verificate che non siano stati rilasciati nuovi code-generator (lo sviluppo su questo fronte è molto attivo) - se non lo avete trovato, potete comunque scrivere le specifiche in openapi v3 e convertirle in v2 con [api-spec-converter](https://lucybot-inc.github.io/api-spec-converter/), che è stato patchato di recente per supportare meglio alcuni casi. Ovviamente la v3 ha delle feature in più - che possiamo conservare a livello di specifica. - se avete specifiche in swagger-2 invece potete: Leggete poi [i tanti post sull’interoperabilità](https://forum.italia.it/c/piano-triennale/interoperabilita) che sono su questo forum! ---
**Author:** ![aborruso](https://forum.italia.it/user_avatar/forum.italia.it/aborruso/32/15_2.png) [@aborruso](https://forum.italia.it/u/aborruso)\ **Post date:** [31 Maggio 2018, 1:36pm UTC](https://forum.italia.it/t/creare-api-interoperabili-dove-partire/3491/2 "2018-05-31T13:36:56Z")
> [@Roberto\_Polli](#): > > Qui trovi un api-starter-kit che, partendo da un openapi-v3: Il link non sembra attivo ---
**Author:** ![Roberto\_Polli](https://forum.italia.it/user_avatar/forum.italia.it/roberto_polli/32/1127_2.png) [@Roberto\_Polli](https://forum.italia.it/u/Roberto_Polli)\ **Post date:** [1 Giugno 2018, 10:11am UTC](https://forum.italia.it/t/creare-api-interoperabili-dove-partire/3491/3 "2018-06-01T10:11:49Z")
Ciao @aborruso, fixed! Grazie per la segnalazione! Per qualsiasi cosa fai sapere anche a roberto@teamdigitale.governo.it. R. ---
**Author:** ![Roberto\_Polli](https://forum.italia.it/user_avatar/forum.italia.it/roberto_polli/32/1127_2.png) [@Roberto\_Polli](https://forum.italia.it/u/Roberto_Polli)\ **Post date:** [27 Agosto 2018, 4:38pm UTC](https://forum.italia.it/t/creare-api-interoperabili-dove-partire/3491/4 "2018-08-27T16:38:28Z")
Ciao @aborruso ho aggiunto un’API autogenerata in Java a partire da openapi v3 [https://github.com/teamdigitale/api-starter-kit](https://github.com/teamdigitale/api-starter-kit) e che supporta anche un’endpoint di test che ritorna randomicamente anche risposte 503 e 429. Tester benvenuti!