FonctionnalitésTarifsÀ proposArticlesDocumentation
Développeurs

API, SDK, MCP et webhooks.

Plateforme développeurDémarrage rapideAuthentificationRéférence de l’APISDKMCPWebhooksErreursPaginationLimites de débitIdempotenceJournal des modificationsPolitique de migration et de versionnage
Documentation API bruteOpenAPI YAMLAsyncAPI YAML
  1. Accueil
  2. /
  3. Développeurs
  4. /
  5. Politique de migration et de versionnage

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 v1 existantes 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.

AccueilFonctionnalitésTarifsÀ proposArticlesDocumentationDéveloppeurs
© FabHubConfidentialité et cookiesConditionsAccessibilité