Changelog della API pubblica
Questa pagina elenca i cambiamenti maggiori della API pubblica CaptainDNS. Le aggiunte non distruttive (nuovi endpoint, campi opzionali) sono documentate qui senza preavviso formale. I cambiamenti di rottura sono annunciati con almeno 30 giorni di anticipo tramite questa pagina e per email ai detentori di chiavi attive.
Politica di versionamento
- Compatibilita all'indietro: aggiungere campi opzionali e nuovi endpoint non rompe i client esistenti.
- Deprecation: un campo o endpoint deprecato resta funzionante per almeno 6 mesi dopo l'annuncio.
- Rotture: i breaking change sono annunciati 30 giorni prima e distribuiti su una URL versionata (es.
/public/v2/*). La URL V1 resta operativa durante la migrazione. - Identificatore di versione: la specifica OpenAPI porta un proprio numero (
info.version).
Versione 0.2.0 - 2026-04-09
Aggiunto
- Oltre 40 endpoint pubblici sotto
/public/v1/*che coprono DNS, mail, web e testo:- 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. - Testo:
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:
- Gestione delle chiavi API dalla dashboard CaptainDNS: elenco, creazione, revoca, rotazione e consultazione dell'uso.
- Schema OpenAPI
PublicAPIErrorcon 10 codici canonici per tutti gli errori della API pubblica. - Header
Idempotency-Keystile Stripe, replay 24 ore,409 IDEMPOTENCY_CONFLICTsu body divergente. - Header
X-Credits-Limit/Remaining/Consumedrestituiti in ogni risposta di successo. - Header
RateLimit,RateLimit-Policy,X-RateLimit-Limit/Remaining/Reset(IETF draft e X-prefixed). - Header
X-Request-Idrestituito in ogni risposta per facilitare il supporto. - 5 piani di fatturazione: Free, Starter, Pro, Business, Enterprise con quote e overage per tier.
- Fatturazione dell'eccedenza opt-in con tetto di budget mensile configurabile dalla dashboard.
- Rilevamento automatico delle fughe tramite il programma GitHub Secret Scanning.
Non incluso in V1
- Webhook: previsto in V2.
- SDK ufficiali: il SDK TypeScript Speakeasy e previsto per la prima consegna.
- mTLS per piani Business ed Enterprise: rimandato.
Restare aggiornati
- Blog CaptainDNS: le release maggiori vengono pubblicate in articoli dedicati su
captaindns.com/it/blog. - Email: i detentori di chiavi attive ricevono una notifica automatica per ogni breaking change.
- Questa pagina: ogni aggiunta o correzione viene registrata qui, in ordine cronologico inverso.
- Specifica OpenAPI: il campo
info.versionviene incrementato a ogni release. Monitorarne il valore consente di avviare automaticamente la rigenerazione degli SDK.
Prossimo passo: torna al quickstart per iniziare l'integrazione, oppure esplora il riferimento OpenAPI per vedere tutti gli schemi in dettaglio.