# Come vengono gestite le versioni API e i cambiamenti che rompono la compatibilità?

Costruire sulla documentazione canonica OpenAPI e registrare la versione del contratto utilizzata dall'integrazione. La politica di ciclo di vita approvata preserva il comportamento legacy fino alla misurazione dell'uso, alla notifica ai clienti e alla conclusione del periodo di migrazione. Prima di aggiornare, confrontare i schemi ed gli esempi, eseguire test di contratto per le risposte di successo e di errore, e mantenere un percorso di annullamento. La pubblicazione rimane controllata dal gate condiviso di rilascio.

## Guida canonica

- /api-documentation
- /openapi/openapi.json