Changelog da API pública
Esta página lista as mudancas maiores da API pública CaptainDNS. Adicoes não destrutivas (novos endpoints, campos opcionais) sao documentadas aqui sem aviso formal. Breaking changes sao anunciados com pelo menos 30 dias de antecedencia via esta página e por email aos detentores de chaves ativas.
Politica de versionamento
- Compatibilidade para tras: adicionar campos opcionais e novos endpoints não quebra clientes existentes.
- Depreciacoes: um campo ou endpoint depreciado permanece funcional por pelo menos 6 meses após o anuncio.
- Quebras: breaking changes sao anunciados com 30 dias de antecedencia e implantados em uma URL versionada (por exemplo
/public/v2/*). A URL V1 continua operando durante o período de migracao. - Identificador de versao: a especificacao OpenAPI carrega seu proprio número (
info.version).
Versao 0.2.0 - 2026-04-09
Adicionado
- 40+ endpoints publicos sob
/public/v1/*cobrindo DNS, email, web e texto:- DNS:
resolve,resolve/propagation,dnssec/check,ip/whois,ip/nslookup,ip/netmask,rdap/lookup,domain/dns-check. - Email:
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. - Texto:
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:
- Gestão de chaves API pela dashboard CaptainDNS: listar, criar, revogar, rotacionar e consultar uso.
- Esquema OpenAPI
PublicAPIErrorcom 10 códigos canonicos para todos os erros. - Header
Idempotency-Keyestilo Stripe, replay 24 horas,409 IDEMPOTENCY_CONFLICTem body divergente. - Headers
X-Credits-Limit/Remaining/Consumedretornados em toda resposta bem sucedida. - Headers
RateLimit,RateLimit-Policy,X-RateLimit-Limit/Remaining/Reset(IETF draft e X-prefixed). - Header
X-Request-Idretornado em toda resposta para facilitar o suporte. - 5 planos de cobranca: Free, Starter, Pro, Business, Enterprise com cotas e excedente por tier.
- Cobrança de excedente opt-in com teto orçamentário mensal configurável pela dashboard.
- Detecção automática de vazamentos via o programa GitHub Secret Scanning.
Não entregue na V1
- Webhooks: previsto para V2.
- SDKs oficiais: o SDK TypeScript Speakeasy esta previsto para a primeira entrega.
- mTLS para planos Business e Enterprise: adiado.
Fique atualizado
- Blog CaptainDNS: as releases maiores sao publicadas em artigos dedicados em
captaindns.com/pt/blog. - Email: os detentores de chaves ativas recebem uma notificacao automatica para qualquer breaking change.
- Esta página: toda adicao ou correcao e registrada aqui, em ordem cronologica inversa.
- Especificacao OpenAPI: o campo
info.versione incrementado a cada release. Monitorar seu valor permite disparar regeneracoes automaticas de SDK.
Proximo passo: volte ao quickstart para comecar a integrar, ou explore a referencia OpenAPI para ver todos os esquemas em detalhe.