Capire il modello di crediti e l'overage

L'API pubblica CaptainDNS è fatturata in crediti. Un semplice lookup DNS costa 1 credito, un deliverability score ne costa 30. Ogni piano include una quota mensile di crediti; il superamento viene fatturato a fine periodo a partire dal piano Starter. Questa pagina spiega i dettagli.

Principio

Un credito non è un'unità di tempo, dati o richieste. È un'unità di costo interno che riflette la quantità 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-6 crediti: una verifica blacklist multi-RBL o un test SMTP completo.
• 8-10 crediti: un crawl HTTP con estrazione di meta o un rilevamento di phishing.
• 30 crediti: uno score che aggrega SPF, DKIM, DMARC, BIMI e reputazione.

Così stimi il consumo di un'integrazione senza contare le singole richieste: moltiplica per il costo medio degli endpoint che chiami e ottieni il volume mensile approssimativo.

Costo per endpoint

La tabella qui sotto elenca gli endpoint principali. Per l'elenco completo dei 59 endpoint e dei relativi costi, consulta il riferimento OpenAPI. Include in particolare i 15 strumenti testuali (1 credito ciascuno) e gli endpoint certificati/BIMI non ripresi qui.

Quote per piano

Fatturazione annuale: 12 mesi fatturati, 10 pagati, ovvero due mesi gratis.

Hard cap: i piani Free e Solo non fatturano overage. Una volta consumati i crediti inclusi (30 su Free, 5.000 su Solo), ogni richiesta restituisce 403 QUOTA_EXCEEDED fino a fine mese. Per evitare il blocco, passa al piano Starter.

Overage soft: dal piano Starter in su i piani 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

• X-Credits-Limit: quota mensile inclusa nel piano corrente.
• X-Credits-Remaining: crediti ancora disponibili nella dotazione del piano. Questo header è limitato a 0 e non scende mai sotto. In overage (da Starter in su) il valore resta a 0; per misurare il volume di overage, leggi X-Credits-Overage oppure confronta X-Credits-Consumed cumulato con X-Credits-Limit.
• X-Credits-Consumed: crediti scalati dalla richiesta corrente.

Usa questi header per pilotare il client: alert all'80% della quota, accodamento delle chiamate non critiche in prossimità del limite.

Consultare il proprio uso

La dashboard CaptainDNS (Profilo > Chiavi API) mostra il mese corrente e i 12 precedenti, con il dettaglio dei crediti consumati, dell'overage e dello storico di fatturazione.

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 prossimità 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, contatta il supporto CaptainDNS.

Prossimi passi: il rate limiting spiega come livellare le chiamate e l'idempotenza come risparmiare crediti nei retry.