Vai al contenuto principale

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.
  • Gestione delle chiavi API dalla dashboard CaptainDNS: elenco, creazione, revoca, rotazione e consultazione dell'uso.
  • Schema OpenAPI PublicAPIError con 10 codici canonici per tutti gli errori della API pubblica.
  • Header Idempotency-Key stile Stripe, replay 24 ore, 409 IDEMPOTENCY_CONFLICT su body divergente.
  • Header X-Credits-Limit/Remaining/Consumed restituiti in ogni risposta di successo.
  • Header RateLimit, RateLimit-Policy, X-RateLimit-Limit/Remaining/Reset (IETF draft e X-prefixed).
  • Header X-Request-Id restituito 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.version viene 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.