Entender o modelo de créditos é o excedente
A API pública CaptainDNS é cobrada em créditos. Um lookup DNS simples custa 1 credito, um deliverability score custa 25. Cada plano inclui uma cota mensal de créditos; o excedente é cobrado no fim do período para os planos pagos. Esta página explica os detalhes.
Principio
Um credito não é uma unidade de tempo, dados ou requisicoes. É uma unidade de custo interno que reflete a quantidade de trabalho feita pelo backend CaptainDNS:
- 1 credito: um lookup DNS em cache.
- 2 a 3 créditos: uma verificação multi-resolver ou uma cadeia DNSSEC.
- 5 créditos: uma verificação blacklist multi-RBL ou um teste SMTP completo.
- 10 créditos: um crawl HTTP com extracao de meta.
- 30 créditos: um score que agrega SPF, DKIM, DMARC, BIMI é reputacao.
Custo por endpoint
A tabela abaixo é a fonte unica da verdade, alinhada com a especificação OpenAPI.
| Endpoint | Créditos | Escopo |
|---|---|---|
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/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/deliverability/score | 30 | 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 |
Cotas por plano
| Plano | Preco mensal | Créditos incluidos | Rate limit (req/min/chave) | Excedente |
|---|---|---|---|---|
| Free | 0 EUR | 500 | 10 | Hard cap (403) |
| Starter | 29 EUR | 50 000 | 60 | 1 EUR / 1 000 créditos |
| Pro | 99 EUR | 500 000 | 500 | 0,80 EUR / 1 000 créditos |
| Business | 199 EUR | 2 000 000 | 1 000 | 0,50 EUR / 1 000 créditos |
| Enterprise | Sob consulta | 5 000 000 | 1 200 | 0,30 EUR / 1 000 créditos |
Cobranca anual com 20 % de desconto (dois meses gratis).
Hard cap: o plano Free não cobra excedente. Assim que os 500 créditos sao consumidos, cada requisicao retorna 403 QUOTA_EXCEEDED até o fim do mes. Para evitar o corte, passe ao plano Starter.
Excedente flexivel: os planos pagos permitem ultrapassar a cota. Os créditos em excedente sao contabilizados separadamente e cobrados no fim do mes.
Headers retornados pela API
Cada resposta bem sucedida inclui tres headers contabeis:
X-Credits-Limit: 50000
X-Credits-Remaining: 37547
X-Credits-Consumed: 2
Use estes headers para dirigir seu cliente: alerta ao atingir 80 % da cota, filas para chamadas não criticas proximas ao esgotamento.
Consultar seu uso
O dashboard /account/api-usage mostra o mes corrente é os 12 anteriores. A API admin expoe os mesmos dados em :
{
"tier": "starter",
"credits_limit": 50000,
"credits_used_current": 12453,
"credits_remaining": 37547,
"overage_credits_current": 0,
"overage_eur_cents_per_1k": 100,
"period_start": "2026-04-01T00:00:00Z",
"period_end": "2026-05-01T00:00:00Z",
"history": [
{
"period_start": "2026-03-01T00:00:00Z",
"credits_used": 47821,
"overage_credits": 0,
"overage_charged_eur_cents": 0
}
]
}
Evitar surpresas
Estimativa previa: multiplique o número esperado de requisicoes pelo custo medio. Um crawler que chama page-crawl-check em 10 000 URLs por mes consome 100 000 créditos, mais do que a cota Starter.
Backoff proximo a cota: monitore X-Credits-Remaining é, aos 10 % restantes, desacelere ou enfileire chamadas não urgentes.
Deduplicacao: se sua integração pode receber requisicoes redundantes, use a idempotência.
Ambientes separados: não coloque sua chave cdns_live_* em um job de CI que roda 20 vezes por push. Crie uma chave cdns_test_* dedicada.
Cobranca do excedente
O excedente é cobrado automaticamente após o fechamento de cada período mensal. O valor é calculado na tarifa do plano e cobrado em uma única transação. Em caso de erros, o sistema tenta novamente automaticamente. Se o problema persistir, entre em contato com o suporte CaptainDNS.
Próximos passos: o rate limiting explica como suavizar suas chamadas e a idempotência como economizar créditos em retries.