Les environnements test et live sont isolés. Utilisez le sandbox pour intégrer, provoquer les erreurs attendues et valider vos webhooks avant de promouvoir configuration et secrets.
Sandbox et production
Configurez explicitement l’URL de base et la clé par environnement. Une clé test ne doit pas accéder aux ressources live et inversement.
Contrat API v1
OpenAPI public et les schémas documentés constituent le contrat. Les changements incompatibles sont bloqués par CI et nécessitent dépréciation ou nouvelle version majeure.
Ajouts compatibles
De nouveaux champs optionnels, endpoints et capabilities peuvent apparaître. Les clients doivent ignorer les champs inconnus et éviter des switches exhaustifs fragiles sur les enums extensibles. La même règle s’applique aux options de conversion propres à une paire : ConverterHQ peut ajouter de nouvelles options facultatives, mais une option v1 existante ne sera ni supprimée, ni rendue obligatoire, ni modifiée dans son type ou sa sémantique par défaut, ni privée de valeurs enum, ni restreinte dans sa plage acceptée.
Dépréciations
Une dépréciation doit être annoncée dans le changelog avec alternative et fenêtre de migration. Ne dépendez pas d’un comportement non documenté ou d’un endpoint interne.