Versions
Ce qui peut changer au sein de la version 1 de la Direct API, ce que votre client doit tolérer, et comment les modèles sont ajoutés et retirés.
La version figure dans le chemin : /v1. Au sein de la v1, les changements sont uniquement des ajouts : nouveaux outils, nouveaux champs d’entrée facultatifs, nouveaux champs de réponse, nouveaux statuts, nouveaux types d’événements et nouveaux codes d’erreur.
Ce que votre client doit gérer
- Ignorer les champs de réponse qu’il ne connaît pas.
- Considérer un statut de génération qu’il ne connaît pas comme non final, et continuer à suivre la génération.
- S’attendre à ce que les schémas d’entrée restent stricts : un champ d’entrée inconnu est refusé, si bien qu’une faute de frappe n’est jamais ignorée en silence.
Changements incompatibles
Un changement incompatible est publié sous /v2, avec au moins 6 mois de coexistence et un préavis adressé à chaque organisation disposant d’une clé active.
Modèles
- Des modèles sont ajoutés et retirés au fil du temps ; Modèles présente toujours l’ensemble actuel.
- Un identifiant de modèle n’est jamais réutilisé et reste toujours accepté. Un identifiant retiré exécute son remplaçant, et les réponses nomment le modèle réellement exécuté.
- Morphic ne peut changer le moteur derrière un identifiant de modèle que pour l’améliorer, à un prix identique ou inférieur, et l’annonce dans le catalogue des modèles.
Si vous rencontrez le moindre problème ou si vous avez des questions, n’hésitez pas à nous contacter. Nous serons ravis de vous aider. Écrivez-nous à support@morphic.com.