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 am Periodenende für bezahlte Pläne 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: multipliziere mit den durchschnittlichen Kosten des oder der aufgerufenen Endpunkte und du erhältst dein ungefähres monatliches Volumen.
Kosten pro Endpunkt
Die folgende Tabelle listet die wichtigsten Endpunkte. Die vollständige Liste der 51 Endpunkte und ihrer Kosten findest du in der OpenAPI-Referenz. Enthalten sind dort auch die 15 Text-Tools (je 1 Credit) und die hier nicht aufgeführten Certificates/BIMI-Endpunkte.
| Endpunkt | Credits | 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 |
Kontingente pro Plan
| Plan | Monatspreis | Enthaltene Credits | Rate Limit (req/min/Schlüssel) | Overage |
|---|---|---|---|---|
| Free | 0 EUR | 30 | 10 | Hard Cap (403) |
| Starter | 29 EUR | 50.000 | 60 | 1 EUR / 1.000 Credits |
| Pro | 99 EUR | 500.000 | 500 | 0,80 EUR / 1.000 Credits |
| Business | 199 EUR | 2.000.000 | 1.000 | 0,50 EUR / 1.000 Credits |
| Enterprise | Auf Anfrage | 5.000.000 | 1.200 | 0,30 EUR / 1.000 Credits |
Jahresabrechnung: 20 % Rabatt (zwei Monate gratis).
Hard Cap: der Free-Plan rechnet keine Overage ab. Sobald die 30 Credits verbraucht sind, liefert jede Anfrage 403 QUOTA_EXCEEDED bis zum Ende der Monatsperiode. Für durchgängigen Betrieb wechsle zu Starter.
Soft Overage: bezahlte Pläne erlauben 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 (nur bezahlte Pläne) bleibt der Wert 0; um das Overage-Volumen zu messen, liesX-Credits-Overageoder vergleiche das kumulierteX-Credits-ConsumedmitX-Credits-Limit.X-Credits-Consumed: Credits, die die aktuelle Anfrage verbraucht hat.
Nutze diese Header zur Steuerung deines Clients: protokolliere die Annäherung an das Kontingent, löse einen Alert bei 80 % aus, verlagere Anrufe in eine Warteschlange, wenn du der Erschöpfung nahekommst.
Verbrauch einsehen
Das CaptainDNS-Dashboard (Account > API usage) zeigt den aktuellen Monat und die vorherigen 12 Monate, mit Details zu verbrauchten Credits, Overage und Abrechnungshistorie.
Überraschungen vermeiden
Vorabschätzung: bevor du eine Integration startest, multipliziere 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: beobachte X-Credits-Remaining, und verlangsame oder parke bei 10 % Restkontingent nicht-dringende Aufrufe.
Deduplikation: wenn deine Integration redundante Anfragen empfangen kann, nutze die Idempotenz. Eine Wiederholung innerhalb von 24 Stunden liefert die gespeicherte Antwort, ohne einen einzigen zusätzlichen Credit zu verbrauchen.
Getrennte Umgebungen: stecke deinen cdns_live_*-Schlüssel nicht in einen CI-Job, der 20-mal pro Push läuft. Erstelle einen eigenen cdns_test_*-Schlüssel und ordne 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, kontaktiere den CaptainDNS-Support.
Nächste Schritte: das Rate Limiting erklärt, wie du deine Aufrufe glättest, und die Idempotenz, wie du Credits bei Retries sparst.