Changelog
Historique des ajouts, corrections contractuelles et dépréciations de l’API externe V1.
Les évolutions de la V1 sont additives lorsque cela est possible. Une rupture contractuelle entraîne une nouvelle version et une période de migration annoncée.
Actuel
V1 — Contrat de production
- Retrait temporaire des opérations POST V1 du contrat public de production.
- Maintien de POST /auth pour l’authentification et des opérations GET et PUT existantes.
V1 — Portail développeurs
- Publication de la référence OpenAPI publique et des guides d’intégration.
- Documentation des parcours Catalogue, Clients et Transactions.
- Mise à disposition du contrat OpenAPI JSON téléchargeable.
V1 — Commandes automatiques
- Ajout de la création atomique d’une réservation ou commande selon le stock.
- Ajout des références externes et de l’idempotence sur les transactions.
V1 — Transactions et cartes cadeaux
- Ajout des réservations, acomptes et cartes cadeaux.
- Introduction des scopes dédiés et des contrôles d’idempotence.
Politique de dépréciation
Une opération dépréciée reste identifiable dans la référence. Les nouvelles intégrations doivent utiliser les routes V1 non dépréciées.
Être informé
Les changements nécessitant une action sont communiqués aux contacts techniques enregistrés pour chaque intégration.