Versionamento delle API¶

Come descritto nelle precedenti sezioni, ogni API possiede una versione. È possibile registrare una nuova versione dell’API cliccando sul pulsante “Nuova Versione” presente nel dettaglio di una API (Fig. 14).

Fig. 14 Nuova Versione di una API¶

La maschera di creazione della nuova versione non permette ne di modificare il nome dell’API ne di scendere di versione. Vengono ereditati dall’API precedente le altre caratteristiche quali il tipo di API tra SOAP e REST, i tags, la descrizione, il soggetto referente etc.

Se l’opzione “Ridefinisci Interfaccia” è abilitata, viene richiesta una nuova specifica dell’interfaccia dell’API. Terminando la creazione della nuova API verranno creati automaticamente i servizi e le azioni su SOAP o le risorse su REST definiti nella nuova interfaccia (Fig. 15).

Fig. 15 Nuova Versione di una API tramite ridefinizione dell’intervaccia¶

In alternativa, se l’opzione “Ridefinisci Interfaccia” viene disabilitata, non viene richiesta una nuova specifica di interfaccia e la nuova versione dell’API conterrà la medesima specifica della precendente versione con i medesimi servizi e azioni su SOAP o risorse su REST (Fig. 16).

Fig. 16 Nuova API che eredita la specifica di interfaccia dalla versione precedente¶

Una volta creata una nuova versione dell’API, è possibile effettuare l’upgrade verso la nuova versione direttamente nell’erogazione e/o nella fruizione che implementa l’API. Infatti se esiste più di una versione di una medesima API è possibile modificarne la versione implementata nell’erogazione o nella fruizione tramite il bottone “modifica” evidenziato nella figura Fig. 17.

Fig. 17 Upgrade di versione dell’API implementata in una erogazione¶

Accedendo alla modifica è possibile scegliere la versione implementata dell’API, tra le versioni disponibili, come mostrato nella figura Fig. 18.

Fig. 18 Scelta della versione dell’API implementata in una erogazione¶

La modifica della versione dell’API implementata dall’erogazione, comporta automaticamente anche la modifica della versione dell’erogazione stessa. Questo si riflette nell’url di invocazione che viene automaticamente aggiornata rispetto alla nuova versione come evidenziato nella figura Fig. 19.

Fig. 19 Modifica della versione si riflette sia sull’erogazione che sulla url di invocazione¶

Per maggiori dettagli sul versionamento differente tra erogazione/fruizione ed API e di conseguenza su come questo si riflette nella url di invocazione si rimanda alla sezione Versionamento delle API e delle Erogazioni/Fruizioni