Politica di Versioning
Schema di Versioning
Le versioni maggiori sono documentate come guide di integrazione separate (es. /guides/shipments/v3). Ogni versione corrisponde a una revisione specifica dello schema dell'entità. Quando viene rilasciata una nuova versione maggiore, i formati JSON (queue) e CSV (SFTP) vengono aggiornati di conseguenza.
Modifiche Non Breaking
- Nuovi campi opzionali nelle entità
- Nuovi valori ammessi per campi enumerati esistenti
- Nuove entità o guide aggiunte al portale
- Messaggi di errore di validazione migliorati
Breaking Changes (richiedono una nuova versione maggiore)
- Rinominare o rimuovere campi
- Cambiare il tipo o il formato dei campi (es. formato data, precisione numerica)
- Rendere obbligatori campi opzionali
- Rimuovere valori ammessi da campi enumerati
- Rimuovere una guida di entità
Ciclo di Vita delle Nuove Versioni
- Annuncio → Beta → GA → Deprecazione → Sunset