Ir al contenido principal
CaptainDNS
✦NUEVO·Status pages vinculadas a tus monitors. White-label, dominio personalizado, RSS, suscriptores.Ver demo en vivo

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

Anadido

  • POST /public/v1/dmarc/validate: respuesta enriquecida con scoring y recomendaciones. Nuevos campos opcionales additivos: state, score, score_band, verdict_headline, verdict_sub, score_factors, score_breakdown, recommendations, passed_checks, parsed_tags. El contrato existente (DMARCAnalysis a nivel raiz) se preserva estrictamente. Coste sin cambios (1 credito), scope sin cambios (mail:read).

Version 0.3.0 - 2026-04-14

Modificado

  • Payload webhook: ahora con schema_version: "2". Nuevos campos event_id, delivery_id, attempt. User-Agent ahora CaptainDNS-Webhook/2.0.
  • Nuevas cabeceras en cada POST: X-CaptainDNS-Event-ID, X-CaptainDNS-Delivery-ID, X-CaptainDNS-Attempt (formato n/6), X-CaptainDNS-Event-Type. Las cabeceras existentes X-CaptainDNS-Signature y X-CaptainDNS-Timestamp no cambian.
  • Política de reintentos: si tu endpoint devuelve 5xx, 408, 429 o un timeout/error de red, se realizan 6 intentos con backoff 10s, 1min, 10min, 1h, 6h, 24h. Las demás respuestas 4xx pasan directamente a failed_permanent sin reintentar.
  • event_id estable en todos los intentos y reenvíos manuales: clave de deduplicación recomendada en el receptor.

Version 0.2.0 - 2026-04-09

Agregado

  • 51 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.
  • Gestión de claves API desde el dashboard CaptainDNS: listado, creación, revocación, rotación y consulta de uso.
  • Esquema OpenAPI PublicAPIError con 10 códigos canonicos para todos los errores.
  • Cabecera Idempotency-Key estilo Stripe, replay a 24 horas, 409 IDEMPOTENCY_CONFLICT ante body divergente.
  • Cabeceras X-Credits-Limit/Remaining/Consumed en cada respuesta exitosa.
  • Cabeceras RateLimit-Policy, X-RateLimit-Limit, X-RateLimit-Remaining (esta ultima se escribe unicamente ante un rechazo 429).
  • Cabecera X-Request-Id en 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.
  • Notification channels (webhooks, Slack) en el dashboard de perfil, con firma HMAC-SHA256 opcional y 22 tipos de eventos. Ver la página dedicada.

No incluido en V1

  • Webhooks de la API pública firmados por clave (tabla webhook_endpoints) para empujar los eventos de tu cuenta hacia tus sistemas.

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.version se 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.