Vai al contenuto principale
CaptainDNS
✦NUOVO·Status page collegate ai tuoi monitor. White-label, dominio personalizzato, RSS, iscritti.Vedi la demo live

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.3.1 - 2026-05-19

Aggiunto

  • POST /public/v1/dmarc/validate: risposta arricchita con scoring e raccomandazioni. Nuovi campi opzionali additivi: state, score, score_band, verdict_headline, verdict_sub, score_factors, score_breakdown, recommendations, passed_checks, parsed_tags. Il contratto esistente (DMARCAnalysis al livello radice) e strettamente preservato. Costo invariato (1 credito), scope invariato (mail:read).

Versione 0.3.0 - 2026-04-14

Modificato

  • Payload webhook: ora con schema_version: "2". Nuovi campi event_id, delivery_id, attempt. User-Agent ora CaptainDNS-Webhook/2.0.
  • Nuovi header su ogni POST: X-CaptainDNS-Event-ID, X-CaptainDNS-Delivery-ID, X-CaptainDNS-Attempt (formato n/6), X-CaptainDNS-Event-Type. Gli header esistenti X-CaptainDNS-Signature e X-CaptainDNS-Timestamp rimangono invariati.
  • Politica di tentativi: se il tuo endpoint restituisce 5xx, 408, 429 o un timeout/errore di rete, vengono effettuati 6 tentativi con backoff 10s, 1min, 10min, 1h, 6h, 24h. Le altre risposte 4xx passano immediatamente a failed_permanent senza ritentare.
  • event_id stabile su tutti i tentativi e rinvii manuali: chiave di deduplicazione consigliata lato destinatario.

Versione 0.2.0 - 2026-04-09

Aggiunto

  • 51 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-Policy, X-RateLimit-Limit, X-RateLimit-Remaining (quest'ultimo scritto solo in caso di rifiuto 429).
  • 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.
  • Notification channel (webhook, Slack) nella dashboard del profilo, con firma HMAC-SHA256 opzionale e 22 tipi di evento. Vedi la pagina dedicata.

Non incluso in V1

  • Webhook della API pubblica firmati per chiave (tabella webhook_endpoints) per inviare gli eventi del tuo account ai tuoi sistemi.

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.