Zum Hauptinhalt springen
CaptainDNS

Das Credit-Modell und die Overage-Abrechnung verstehen

Die CaptainDNS Public API wird in Credits abgerechnet. Ein einfacher DNS-Lookup kostet 1 Credit, ein Deliverability-Score 30. Jeder Plan beinhaltet ein monatliches Credit-Kontingent; Überschreitungen (Overage) werden ab dem Starter-Plan am Periodenende abgerechnet. Diese Seite erläutert die Details.

Prinzip

Ein Credit ist keine Einheit für Zeit, Daten oder Requests. Es ist eine Kosteneinheit, die den Arbeitsaufwand von CaptainDNS widerspiegelt:

  • 1 Credit: ein gecachter DNS-Lookup.
  • 2-3 Credits: eine Multi-Resolver-Prüfung oder eine DNSSEC-Kette.
  • 5-6 Credits: ein Multi-RBL-Blacklist-Check oder ein vollständiger SMTP-Test.
  • 8-10 Credits: ein HTTP-Crawl mit Metadaten-Extraktion oder eine Phishing-Erkennung.
  • 30 Credits: ein Deliverability-Score, der SPF, DKIM, DMARC, BIMI und Reputation aggregiert.

Damit lässt sich der Verbrauch einer Integration abschätzen, ohne die exakte Request-Zahl berechnen zu müssen: multiplizieren Sie mit den durchschnittlichen Kosten des oder der aufgerufenen Endpunkte, und Sie erhalten Ihr ungefähres monatliches Volumen.

Kosten pro Endpunkt

Die folgende Tabelle listet die wichtigsten Endpunkte. Die vollständige Liste der 59 Endpunkte und ihrer Kosten finden Sie in der OpenAPI-Referenz. Enthalten sind dort auch die 15 Text-Tools (je 1 Credit) und die hier nicht aufgeführten Certificates/BIMI-Endpunkte.

EndpunktCreditsScope
POST /public/v1/resolve1dns:read
POST /public/v1/resolve/propagation3dns:read
POST /public/v1/dnssec/check3dns:read
POST /public/v1/ip/whois2dns:read
POST /public/v1/ip/nslookup1dns:read
POST /public/v1/ip/netmask1dns:read
POST /public/v1/rdap/lookup2dns:read
POST /public/v1/domain/dns-check5dns:read
POST /public/v1/spf/lookup1mail:read
POST /public/v1/dkim/lookup1mail:read
POST /public/v1/dmarc/lookup1mail:read
POST /public/v1/bimi/lookup2mail:read
POST /public/v1/mta-sts/lookup2mail:read
POST /public/v1/tls-rpt/lookup2mail:read
POST /public/v1/dane/lookup2mail:read
POST /public/v1/blacklist/ip5mail:read
POST /public/v1/smtp/check6mail:read
POST /public/v1/mail/header-audit2mail:read
POST /public/v1/mail/domain-check10mail:read
GET /public/v1/spf/hosted1mail:read
GET /public/v1/spf/hosted/{id}1mail:read
GET /public/v1/spf/hosted/{id}/history2mail:read
GET /public/v1/spf/hosted/{id}/stats2mail:read
POST /public/v1/deliverability/score30mail:write
POST /public/v1/dmarc/generate1mail:write
POST /public/v1/spf/hosted/{id}/resolve5mail:write
POST /public/v1/url/check3web:read
POST /public/v1/page/crawl-check10web:read
POST /public/v1/phishing/check8web:read
POST /public/v1/http/headers-check2web:read
POST /public/v1/http/hsts-check3web:read
POST /public/v1/certificates/ssl/check2web:read

Kontingente pro Plan

PlanMonatspreisEnthaltene CreditsRate Limit (req/min/Schlüssel)Overage
Free0 EUR3010Hard Cap (403)
Solo9 EUR5.00010Hard Cap (403)
Starter29 EUR50.000601 EUR / 1.000 Credits
Pro99 EUR500.0005000,80 EUR / 1.000 Credits
Business199 EUR2.000.0001.0000,50 EUR / 1.000 Credits
EnterpriseAuf Anfrage5.000.0001.2000,30 EUR / 1.000 Credits

Jahresabrechnung: 12 Monate berechnet, davon nur 10 bezahlt, also zwei Monate gratis.

Hard Cap: die Pläne Free und Solo rechnen keine Overage ab. Sobald die enthaltenen Credits verbraucht sind (30 bei Free, 5.000 bei Solo), liefert jede Anfrage 403 QUOTA_EXCEEDED bis zum Ende der Monatsperiode. Für durchgängigen Betrieb wechseln Sie zu Starter.

Soft Overage: ab Starter erlauben die Pläne das Überschreiten des Kontingents. Overage-Credits werden separat geführt und am Monatsende abgerechnet. Die tatsächliche Abrechnung wird erst nach dem Periodenschluss ausgelöst.

Von der API zurückgegebene Header

Jede Antwort der Public API enthält drei Accounting-Header:

X-Credits-Limit: 50000
X-Credits-Remaining: 37547
X-Credits-Consumed: 2
  • X-Credits-Limit: monatliches Kontingent des aktuellen Plans.
  • X-Credits-Remaining: noch verfügbare Credits im Plan-Kontingent. Dieser Header ist bei 0 gedeckelt und wird niemals negativ. In der Overage (ab Starter) bleibt der Wert 0; um das Overage-Volumen zu messen, lesen Sie X-Credits-Overage oder vergleichen Sie das kumulierte X-Credits-Consumed mit X-Credits-Limit.
  • X-Credits-Consumed: Credits, die die aktuelle Anfrage verbraucht hat.

Nutzen Sie diese Header zur Steuerung Ihres Clients: protokollieren Sie die Annäherung an das Kontingent, lösen Sie einen Alert bei 80 % aus, verlagern Sie Aufrufe in eine Warteschlange, wenn Sie der Erschöpfung nahekommen.

Verbrauch einsehen

Das CaptainDNS-Dashboard (Profil > API-Schlüssel) zeigt den aktuellen Monat und die vorherigen 12 Monate, mit Details zu verbrauchten Credits, Overage und Abrechnungshistorie.

Überraschungen vermeiden

Vorabschätzung: bevor Sie eine Integration starten, multiplizieren Sie die erwartete Anzahl an Anfragen mit den durchschnittlichen Kosten. Ein Crawler, der page-crawl-check auf 10.000 URLs pro Monat ausführt, verbraucht 100.000 Credits, also mehr als das Starter-Kontingent (50.000).

Backoff in Quotennähe: beobachten Sie X-Credits-Remaining, und verlangsamen oder parken Sie bei 10 % Restkontingent nicht-dringende Aufrufe.

Deduplikation: wenn Ihre Integration redundante Anfragen empfangen kann, nutzen Sie die Idempotenz. Eine Wiederholung innerhalb von 24 Stunden liefert die gespeicherte Antwort, ohne einen einzigen zusätzlichen Credit zu verbrauchen.

Getrennte Umgebungen: stecken Sie Ihren cdns_live_*-Schlüssel nicht in einen CI-Job, der 20-mal pro Push läuft. Erstellen Sie einen eigenen cdns_test_*-Schlüssel und ordnen Sie ihn einem passenden Plan zu (auch demselben Plan, aber separat im Dashboard erfasst).

Overage-Abrechnung

Die Overage wird nach Abschluss jeder Monatsperiode automatisch abgerechnet. Der Betrag wird zum Plan-Tarif (siehe Tabelle oben) berechnet und in einem Zug abgerechnet. Bei einem Abrechnungsfehler startet das System automatisch einen erneuten Versuch. Falls das Problem bestehen bleibt, kontaktieren Sie den CaptainDNS-Support.

Nächste Schritte: das Rate Limiting erklärt, wie Sie Ihre Aufrufe glätten, und die Idempotenz, wie Sie Credits bei Retries sparen.