Capire il modello di crediti è l'overage
La API pubblica CaptainDNS è fatturata in crediti. Un semplice lookup DNS costa 1 credito, un deliverability score ne costa 25. Ogni piano include una quota mensile di crediti; il superamento viene fatturato a fine periodo per i piani a pagamento. Questa pagina spiega i dettagli.
Principio
Un credito non è un'unita di tempo, dati o richieste. E un'unita di costo interno che riflette la quantita di lavoro svolta dal backend CaptainDNS:
- 1 credito: un lookup DNS in cache.
- 2-3 crediti: una verifica multi-resolver o una catena DNSSEC.
- 5 crediti: una verifica blacklist multi-RBL o un test SMTP completo.
- 10 crediti: un crawl HTTP con estrazione di meta.
- 30 crediti: un score che aggrega SPF, DKIM, DMARC, BIMI è reputazione.
Costo per endpoint
La tabella seguente è la fonte unica di verita, allineata con la specifica OpenAPI.
| Endpoint | Crediti | 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/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 |
Quote per piano
| Piano | Prezzo mensile | Crediti inclusi | Rate limit (req/min/chiave) | Overage |
|---|---|---|---|---|
| Free | 0 EUR | 500 | 10 | Hard cap (403) |
| Starter | 29 EUR | 50 000 | 60 | 1 EUR / 1 000 crediti |
| Pro | 99 EUR | 500 000 | 500 | 0,80 EUR / 1 000 crediti |
| Business | 199 EUR | 2 000 000 | 1 000 | 0,50 EUR / 1 000 crediti |
| Enterprise | Su richiesta | 5 000 000 | 1 200 | 0,30 EUR / 1 000 crediti |
Fatturazione annuale: 20 % di sconto (due mesi gratis).
Hard cap: il piano Free non fattura overage. Una volta consumati i 500 crediti, ogni richiesta restituisce 403 QUOTA_EXCEEDED fino a fine mese. Per evitare il blocco, passa al piano Starter.
Overage soft: i piani a pagamento permettono di superare la quota. I crediti in eccesso sono contabilizzati separatamente e fatturati a fine mese.
Header restituiti dall'API
Ogni risposta di successo include tre header contabili:
X-Credits-Limit: 50000
X-Credits-Remaining: 37547
X-Credits-Consumed: 2
Usa questi header per pilotare il client: alert al 80 % della quota, accodamento delle chiamate non critiche in prossimita del limite.
Consultare il proprio uso
La dashboard /account/api-usage mostra il mese corrente è i 12 precedenti. L'API admin espone gli stessi dati con :
{
"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
}
]
}
Evitare sorprese
Stima preliminare: moltiplica il numero di richieste previste per il costo medio. Un crawler che chiama page-crawl-check su 10 000 URL al mese consuma 100 000 crediti, più della quota Starter.
Backoff in prossimita della quota: monitora X-Credits-Remaining e, al 10 % residuo, rallenta o accoda le chiamate non urgenti.
Deduplica: se la tua integrazione può ricevere richieste ridondanti, usa l'idempotenza.
Ambienti separati: non inserire la tua chiave cdns_live_* in un job CI che gira 20 volte per push. Crea una chiave cdns_test_* dedicata.
Fatturazione dell'overage
L'overage viene fatturato automaticamente dopo la chiusura di ogni periodo mensile. L'importo viene calcolato alla tariffa del piano e addebitato in un'unica transazione. In caso di errori, il sistema ritenta automaticamente. Se il problema persiste, contattate il supporto CaptainDNS.
Su un 5xx di Paddle, il worker riprova con backoff esponenziale (1s, 5s, 25s). Un 429 di Paddle causa un backoff fisso di 30s. I 4xx diversi da 429 non sono ritentati automaticamente.
Prossimi passi: il rate limiting spiega come suavizzare le chiamate è l'idempotenza come risparmiare crediti nei retry.