Changelog der Public API
Diese Seite listet die wichtigsten Änderungen der CaptainDNS Public API. Nicht brechende Ergänzungen (neue Endpunkte, neue optionale Felder) werden hier ohne formelle Ankündigung dokumentiert. Breaking Changes werden mindestens 30 Tage vor dem Deployment angekündigt, hier und per E-Mail an aktive Schlüsselinhaber.
Versionierungsregeln
- Rückwärtskompatibilität: das Hinzufügen optionaler Felder und neuer Endpunkte bricht keine bestehenden Clients.
- Deprecations: ein abgekündigtes Feld oder ein abgekündigter Endpunkt bleibt mindestens 6 Monate nach der Ankündigung funktionsfähig.
- Brüche: Breaking Changes werden 30 Tage im Voraus angekündigt und unter einer neuen versionierten URL (z. B.
/public/v2/*) deployt. Die V1-URL bleibt während der Migrationsperiode erreichbar. - Versionsidentifikator: die OpenAPI-Spezifikation trägt eine eigene Versionsnummer (
info.version).
Version 0.2.0 - 2026-04-09
Hinzugefügt
- Mehr als 40 öffentliche Endpunkte unter
/public/v1/*für DNS, Mail, Web und Text:- DNS:
resolve,resolve/propagation,dnssec/check,ip/whois,ip/nslookup,ip/netmask,rdap/lookup,domain/dns-check. - Mail:
spf/lookup,spf/validate,dkim/lookup,dkim/validate,dmarc/lookup,dmarc/validate,dmarc/generate,dmarcbis/check,dmarcbis/migrate,dmarc/report/analyze,bimi/lookup,bimi/validate,bimi/logo/lookup,mta-sts/lookup,tls-rpt/lookup,dane/lookup,blacklist/ip,smtp/check,mail/header-audit,mail/header-analyze,mail/domain-check,deliverability/score,certificates/csr/parse,certificats/bimi/parse,certificats/bimi/lookup. - Web:
url/check,page/crawl-check,phishing/check. - Text:
text/lower,text/upper,text/stats,text/slug,text/base64/encode,text/base64/decode,text/password/generate,text/urlencode,text/urldecode,text/json/format,text/json/to-yaml,text/yaml/format,text/yaml/to-json,text/hash,text/regex/test.
- DNS:
- Verwaltung von API-Schlüsseln über das CaptainDNS-Dashboard: Auflisten, Erstellen, Widerrufen, Rotieren und Usage-Abfrage.
- OpenAPI-Schema
PublicAPIErrormit 10 kanonischen Codes für alle Fehler der Public API. - Stripe-Style
Idempotency-Key-Header, 24-Stunden-Replay,409 IDEMPOTENCY_CONFLICTbei abweichendem Body. - Header
X-Credits-Limit/Remaining/Consumedbei jeder erfolgreichen Antwort. - Header
RateLimit,RateLimit-Policy,X-RateLimit-Limit/Remaining/Reset(IETF Draft plus X-Prefixed). - Header
X-Request-Idbei jeder Antwort zur Erleichterung des Supports. - 5 Abrechnungspläne: Free, Starter, Pro, Business, Enterprise mit Kontingenten und Overage pro Tier.
- Opt-in-Überschreitungsabrechnung mit konfigurierbarem monatlichem Budgetlimit im Dashboard.
- Automatische Leak-Erkennung über das GitHub Secret Scanning Programm.
In V1 nicht enthalten
- Webhooks: geplant für V2.
- Offizielle SDKs: das TypeScript-SDK (Speakeasy) ist für die erste Lieferung geplant.
- mTLS für Business- und Enterprise-Pläne: verschoben.
Auf dem Laufenden bleiben
- CaptainDNS-Blog: wichtige Releases werden in eigenen Beiträgen auf
captaindns.com/de/blogveröffentlicht. - E-Mail: aktive Schlüsselinhaber erhalten eine automatische Benachrichtigung bei jedem Breaking Change.
- Diese Seite: jede Ergänzung oder Korrektur wird hier chronologisch rückwärts festgehalten.
- OpenAPI-Spezifikation: das Feld
info.versionwird bei jedem Release hochgezählt. Die Überwachung dieses Wertes ermöglicht automatische SDK-Neugenerierungen.
Nächster Schritt: zurück zum Quickstart um mit der Integration zu beginnen, oder die OpenAPI-Referenz für alle Schemas erkunden.