Versions
La version majeure est dans l'adresse : https://kelki.ai/api/v1. À l'intérieur d'une version, les changements sont seulement des ajouts.
Ce qui peut changer dans la v1
- Nouveaux champs dans les réponses, nouvelles routes, nouveaux codes d'erreur.
- Nouvelles valeurs d'une énumération documentée comme extensible.
Votre code doit ignorer les champs inconnus et traiter un code d'erreur inconnu selon son statut HTTP.
Changement incompatible
- Il ouvre une nouvelle version (
/v2) ; aujourd'hui,/v2…répond404 not_found. /v1reste servie au moins 12 mois après l'annonce.- L'annonce passe par le journal des changements et par les en-têtes
Deprecation(RFC 9745) etSunset(RFC 8594) sur les réponses concernées.
Savoir quelle version vous répond
Chaque réponse porte Kelki-Api-Version: 1 et la date de révision. Les événements de webhook portent api_version.