Policy di migrazione e versionamento

L'API pubblica preserva la compatibilità all'interno di v1. Le modifiche incompatibili richiedono una revisione esplicita della policy, una voce nel changelog e un percorso di migrazione.

Impegni di compatibilità

I campi e gli endpoint additivi possono essere rilasciati all'interno di v1.
I campi di risposta esistenti non cambieranno significato all'interno di v1.
I campi di richiesta obbligatori non verranno aggiunti alle scritture v1 esistenti senza un piano di compatibilità.
Le superfici dell'SDK e di MCP sono verificate rispetto allo stesso modello di scope e operazioni OpenAPI.

Cosa significa per te

Tollera campi nuovi e non riconosciuti nelle risposte (non fallire su di essi).
Fissa l'SDK a una versione nota e aggiorna in modo deliberato.
Tieni d'occhio il Changelog per le modifiche additive.

Policy della sorgente

La policy sulle modifiche incompatibili è mantenuta in docs/developer-platform/openapi-breaking-change-policy.md ed è applicata dai controlli sul contratto.

Policy di migrazione e versionamento

L'API pubblica preserva la compatibilità all'interno di v1. Le modifiche incompatibili richiedono una revisione esplicita della policy, una voce nel changelog e un percorso di migrazione.

Impegni di compatibilità

I campi e gli endpoint additivi possono essere rilasciati all'interno di v1.
I campi di risposta esistenti non cambieranno significato all'interno di v1.
I campi di richiesta obbligatori non verranno aggiunti alle scritture v1 esistenti senza un piano di compatibilità.
Le superfici dell'SDK e di MCP sono verificate rispetto allo stesso modello di scope e operazioni OpenAPI.

Cosa significa per te

Tollera campi nuovi e non riconosciuti nelle risposte (non fallire su di essi).
Fissa l'SDK a una versione nota e aggiorna in modo deliberato.
Tieni d'occhio il Changelog per le modifiche additive.

Policy della sorgente

La policy sulle modifiche incompatibili è mantenuta in docs/developer-platform/openapi-breaking-change-policy.md ed è applicata dai controlli sul contratto.