Changelog de la API pública
Esta página lista los cambios mayores de la API pública de CaptainDNS. Las adiciones no destructivas (nuevos endpoints, campos opcionales) se documentan aqui sin aviso formal. Los cambios de ruptura se anuncian con al menos 30 dias de antelacion por esta misma via y por email a los titulares de claves activas.
Politica de versiones
- Compatibilidad hacia atras: anadir campos opcionales y nuevos endpoints no rompe los clientes existentes.
- Deprecations: un campo o endpoint deprecado permanece operativo al menos 6 meses tras el anuncio.
- Rupturas: los cambios de ruptura se anuncian 30 dias antes y se despliegan en una URL versionada (por ejemplo
/public/v2/*). La URL V1 sigue operativa durante el período de migracion. - Identificador de version: la especificacion OpenAPI lleva su propio número (
info.version).
Version 0.2.0 - 2026-04-09
Agregado
- 40+ endpoints publicos bajo
/public/v1/*que cubren DNS, correo, web y texto:- DNS:
resolve,resolve/propagation,dnssec/check,ip/whois,ip/nslookup,ip/netmask,rdap/lookup,domain/dns-check. - Correo:
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:
- Gestión de claves API desde el dashboard CaptainDNS: listado, creación, revocación, rotación y consulta de uso.
- Esquema OpenAPI
PublicAPIErrorcon 10 códigos canonicos para todos los errores. - Cabecera
Idempotency-Keyestilo Stripe, replay a 24 horas,409 IDEMPOTENCY_CONFLICTante body divergente. - Cabeceras
X-Credits-Limit/Remaining/Consumeden cada respuesta exitosa. - Cabeceras
RateLimit,RateLimit-Policy,X-RateLimit-Limit/Remaining/Reset(IETF draft y X-prefixed). - Cabecera
X-Request-Iden todas las respuestas para facilitar el soporte. - 5 planes de facturacion: Free, Starter, Pro, Business, Enterprise, con cuotas y excedente por tier.
- Facturación de excedente opt-in con tope presupuestario mensual configurable desde el dashboard.
- Detección automática de fugas via el programa GitHub Secret Scanning.
No incluido en V1
- Webhooks: previsto para V2.
- SDKs oficiales: el SDK TypeScript Speakeasy esta previsto para la primera entrega.
- mTLS para planes Business y Enterprise: aplazado.
Mantenerse al dia
- Blog CaptainDNS: las releases mayores se publican en articulos dedicados en
captaindns.com/es/blog. - Email: los titulares de claves activas reciben una notificacion automatica ante cualquier cambio de ruptura.
- Esta página: toda adicion o correccion se consigna aqui, en orden cronologico inverso.
- Especificacion OpenAPI: el campo
info.versionse incrementa en cada release. Monitorizar su valor permite disparar las regeneraciones de SDK.
Siguiente paso: vuelve al quickstart para empezar a integrar, o explora la referencia OpenAPI para ver todos los esquemas en detalle.