Webhooks : bientot disponibles
Les webhooks permettent à CaptainDNS de pousser des événements vers vos systèmes en temps réel, sans que vous ayez à interroger l'API en polling. Ils sont en développement pour la V2 de l'API publique et ne sont pas encore disponibles en production. Cette page explique le plan et les alternatives à utiliser d'ici là.
Statut
- V1 (actuel) : webhooks non disponibles.
- V2 (prévu) : émission d'événements, signature HMAC, retry avec backoff exponentiel et dashboard de monitoring.
Aucune date ferme n'est encore annoncée pour la V2. L'avancement sera communiqué dans le changelog et sur le blog CaptainDNS.
Cas d'usage prévus
Voici les événements qui sont envisagés pour la V2 :
api_key.rotated: une clé est rotée, l'ancienne entre en grace period. Utile pour mettre à jour votre gestionnaire de secrets automatiquement.api_key.revoked: une clé est révoquée. Utile pour retirer immédiatement une intégration compromise.api_key.expires_soon: une clé approche de sa date d'expiration (typiquement J-30).usage.threshold_reached: la consommation de crédits franchit un seuil (80 %, 100 %, 120 %).usage.overage_reported: l'overage mensuel a été facturé avec succès.monitoring.alert: une anomalie est détectée sur une clé (spike dix fois la moyenne, salve de 429, etc.).
Ces événements sont des propositions ; la liste définitive sera arrêtée après retour des premiers utilisateurs de la V1.
Alternatives temporaires
En attendant la V2, utilisez l'un des patterns suivants :
Polling via les headers de réponse
Chaque réponse de l'API publique contient les headers X-Credits-Remaining et X-Credits-Limit. Un cron quotidien qui appelle un endpoint peu coûteux suffit à déclencher des alertes sur seuil de consommation.
Vous pouvez aussi consulter votre usage dans le dashboard CaptainDNS (Account > API usage).
Supervision côté client
Dans votre client, surveillez les headers X-Credits-Remaining et X-RateLimit-Remaining retournés à chaque réponse. Si l'un ou l'autre descend sous un seuil critique, déclenchez une alerte maison.
Sentinelle programmée
Programmez un job planifié qui appelle un endpoint peu coûteux (par exemple POST /public/v1/resolve sur un domaine canary) et journalise le status et les headers. Une série de 401/403 inattendus indique un problème, et la métrique X-Credits-Remaining sert de signal préalable au basculement de plan.
Ce que la V2 apportera
Quand les webhooks seront disponibles, vous pourrez :
- Enregistrer un endpoint HTTPS dans le dashboard
/account/webhooks. - Choisir les événements à recevoir via un ensemble de cases à cocher.
- Définir un secret partagé pour valider la signature HMAC de chaque livraison.
- Consulter le dashboard des livraisons réussies, échouées et en attente de retry.
- Replayer manuellement une livraison échouée depuis le dashboard.
Le plan Starter devrait inclure 3 endpoints, Pro 10, Business et Enterprise illimités (sous réserve de la fair-use policy).
Inscription aux annonces
Pour être prévenu du lancement des webhooks :
- Abonnez-vous au blog CaptainDNS : les nouvelles fonctionnalités majeures sont annoncées en article dédié.
- Surveillez le changelog de l'API publique, mis à jour à chaque release.
- Les clients Enterprise avec un account manager recevront une pré-annonce par email, avec possibilité de tester la beta.
En attendant, le quickstart et la référence OpenAPI restent la meilleure porte d'entrée pour intégrer l'API aujourd'hui.