Comprendre le modèle de crédits et l'overage
L'API publique CaptainDNS est facturée en crédits. Un lookup DNS simple coûte 1 crédit, un score de délivrabilité en coûte 30. Chaque plan inclut un quota mensuel de crédits ; le dépassement (overage) est facturé en fin de période pour les plans payants. Cette page explique le détail.
Principe
Un crédit n'est pas une unité de temps, ni de données, ni de requêtes. C'est une unité de coût qui reflète la quantité de travail effectuée par CaptainDNS :
- 1 crédit : un lookup DNS en cache.
- 2-3 crédits : une vérification multi-resolvers ou une chaîne DNSSEC.
- 5-6 crédits : une vérification blacklist multi-RBL ou un test SMTP complet.
- 8-10 crédits : un crawl HTTP avec extraction meta ou une détection phishing.
- 30 crédits : un score de délivrabilité agrégeant SPF, DKIM, DMARC, BIMI, réputation.
Cela vous permet d'anticiper la consommation d'une intégration sans avoir à calculer le nombre exact de requêtes : multipliez par le coût moyen du ou des endpoints appelés et vous avez votre volume mensuel approximatif.
Coût par endpoint
Le tableau ci-dessous est aligné avec la spécification OpenAPI. Si vous reproduisez ce tableau dans un système tiers, pensez à le mettre à jour lors des changements de version. Consultez la référence OpenAPI pour la liste exhaustive des endpoints, incluant les outils texte (1 crédit chacun).
| Endpoint | Crédits | Scope |
|---|---|---|
POST /public/v1/resolve | 1 | dns:read |
POST /public/v1/resolve/propagation | 3 | dns:read |
POST /public/v1/dnssec/check | 3 | dns:read |
POST /public/v1/ip/whois | 2 | dns:read |
POST /public/v1/ip/nslookup | 1 | dns:read |
POST /public/v1/ip/netmask | 1 | dns:read |
POST /public/v1/rdap/lookup | 2 | dns:read |
POST /public/v1/domain/dns-check | 5 | dns:read |
POST /public/v1/spf/lookup | 1 | mail:read |
POST /public/v1/dkim/lookup | 1 | mail:read |
POST /public/v1/dmarc/lookup | 1 | mail:read |
POST /public/v1/bimi/lookup | 2 | mail:read |
POST /public/v1/mta-sts/lookup | 2 | mail:read |
POST /public/v1/tls-rpt/lookup | 2 | mail:read |
POST /public/v1/dane/lookup | 2 | mail:read |
POST /public/v1/blacklist/ip | 5 | mail:read |
POST /public/v1/smtp/check | 6 | mail:read |
POST /public/v1/mail/header-audit | 2 | mail:read |
POST /public/v1/mail/domain-check | 10 | mail:read |
POST /public/v1/deliverability/score | 30 | mail:write |
POST /public/v1/dmarc/generate | 1 | mail:write |
POST /public/v1/url/check | 3 | web:read |
POST /public/v1/page/crawl-check | 10 | web:read |
POST /public/v1/phishing/check | 8 | web:read |
Quotas par plan
| Plan | Prix mensuel | Crédits inclus | Rate limit (req/min/clé) | Overage |
|---|---|---|---|---|
| Free | 0 EUR | 500 | 10 | Hard cap (403) |
| Starter | 29 EUR | 50 000 | 60 | 1 EUR / 1 000 crédits |
| Pro | 99 EUR | 500 000 | 500 | 0,80 EUR / 1 000 crédits |
| Business | 199 EUR | 2 000 000 | 1 000 | 0,50 EUR / 1 000 crédits |
| Enterprise | Sur devis | 5 000 000 | 1 200 | 0,30 EUR / 1 000 crédits |
Annuel = 20 % de réduction (deux mois offerts).
Hard cap : le plan Free ne facture pas l'overage. Une fois les 500 crédits consommés, chaque requête retourne 403 QUOTA_EXCEEDED jusqu'à la fin de la période mensuelle. Pour éviter la coupure, passez au plan Starter.
Overage soft : les plans payants permettent de dépasser le quota. Les crédits en overage sont comptabilisés séparément et facturés à la fin de chaque mois. La facturation réelle n'est déclenchée qu'après la clôture de la période mensuelle.
Headers retournés par l'API
Chaque réponse de l'API publique contient trois headers de comptabilité :
X-Credits-Limit: 50000
X-Credits-Remaining: 37547
X-Credits-Consumed: 2
X-Credits-Limit: quota mensuel inclus dans le plan courant.X-Credits-Remaining: crédits encore disponibles dans l'enveloppe du plan. Une fois négatif, vous êtes en overage (plans payants uniquement).X-Credits-Consumed: crédits décomptés par la requête en cours.
Utilisez ces headers pour piloter votre client : journaliser l'approche du quota, déclencher une alerte à 80 %, basculer sur une file d'attente si vous approchez de l'épuisement.
Consulter son usage
Le dashboard CaptainDNS (Account > API usage) affiche le mois courant et les 12 mois précédents, avec le détail des crédits consommés, de l'overage et de l'historique de facturation.
Éviter les surprises
Estimation préalable : avant de lancer une intégration, multipliez le nombre attendu de requêtes par le coût moyen. Un crawler qui appelle page-crawl-check sur 10 000 URL par mois consomme 100 000 crédits, soit plus que le quota Starter (50 000).
Backoff quand le quota approche : surveillez X-Credits-Remaining, et quand il atteint 10 % du quota, ralentissez ou mettez en file d'attente les appels non urgents.
Déduplication : si votre intégration peut recevoir des demandes redondantes, utilisez l'idempotence. Un replay dans les 24 heures retourne la réponse stockée sans consommer un seul crédit supplémentaire.
Environnements séparés : ne mettez pas votre clé cdns_live_* dans un job de CI qui tourne 20 fois par push. Créez une clé cdns_test_* dédiée et affectez-la à un plan adapté (voire au même plan, mais comptabilisée séparément dans le dashboard).
Facturation de l'overage
L'overage est facturé automatiquement après la clôture de chaque période mensuelle. Le montant est calculé au tarif du plan (voir le tableau ci-dessus) et facturé en une seule fois. En cas d'erreur de facturation, le système réessaie automatiquement. Si le problème persiste, contactez le support CaptainDNS.
Prochaines étapes : le rate limiting explique comment lisser vos appels, et l'idempotence comment économiser des crédits sur les retries.