Politique de migration et de versionnage
L'API publique préserve la compatibilité au sein de v1. Les changements cassants nécessitent une revue de politique explicite, une entrée de changelog et une voie de migration.
Engagements de compatibilité
- Des champs et des endpoints additifs peuvent être livrés au sein de
v1. - Les champs de réponse existants ne changeront pas de signification au sein de
v1. - Des champs de requête obligatoires ne seront pas ajoutés aux écritures
v1existantes sans plan de compatibilité. - Les surfaces du SDK et de MCP sont vérifiées par rapport au même modèle de scopes et d'opérations OpenAPI.
Ce que cela signifie pour vous
- Tolérez les champs nouveaux et non reconnus dans les réponses (n'échouez pas dessus).
- Épinglez le SDK à une version connue et mettez à niveau délibérément.
- Surveillez le Changelog pour les changements additifs.
Politique de la source
La politique de changement cassant est maintenue dans docs/developer-platform/openapi-breaking-change-policy.md et appliquée par des vérifications de contrat.