Versions & rétention

Versions

La version actuelle de l’API est la v1. Elle figure dans chaque URL (/v1/…) et dans chaque event de webhook ("api_version": "v1").

Au sein d’une version, les changements sont uniquement additifs :

nouveaux endpoints, nouveaux paramètres optionnels, nouveaux types d’events ;
nouveaux champs dans les réponses et les payloads ;
nouvelles valeurs dans les énumérations (un nouveau kind d’alerte, par exemple).

Un champ n’est jamais retiré ni renommé au sein d’une version, et son sens ne change jamais. Écrivez votre intégration pour ignorer les champs qu’elle ne connaît pas, et pour accepter sans casser une valeur d’énumération inconnue.

Un changement cassant ferait l’objet d’une nouvelle version (/v2), annoncée longtemps à l’avance dans le changelog, les deux versions tournant côte à côte.

Rétention

Donnée	Conservée
Logs des requêtes API (dashboard → Développeurs → Logs)	30 jours
Events (`GET /v1/events`, dashboard → Développeurs → Events)	30 jours
Tentatives de livraison des webhooks	30 jours
Clés d’idempotence	24 heures

Les enregistrements plus anciens sont purgés automatiquement chaque jour. Les clés API révoquées sont conservées : l’historique des accès reste auditable.