Webhooks: proximamente disponibles

Los webhooks permiten a CaptainDNS enviar eventos a tus sistemas en tiempo real, sin que tengas que hacer polling de la API. Estan en desarrollo para la V2 de la API pública y aun no estan disponibles en producción. Esta página explica el plan y las alternativas temporales.

Estado

• V1 (actual): webhooks no disponibles. La tabla webhook_endpoints existe en la base pero ningun endpoint admin ni emisor backend la consume.
• V2 (previsto): emision de eventos, firma HMAC, reintentos con backoff exponencial y dashboard de monitorizacion de entregas.

Todavia no hay una fecha firme para la V2. El avance se comunicara en el changelog y en el blog de CaptainDNS.

Casos de uso previstos

Los eventos que se estudian para la V2:

• api_key.rotated: una clave se ha rotado, la antigua entra en grace period.
• api_key.revoked: una clave se ha revocado.
• api_key.expires_soon: una clave se acerca a su fecha de expiración (habitualmente D-30).
• usage.threshold_reached: el consumo de créditos cruza un umbral (80 %, 100 %, 120 %).
• usage.overage_reported: el overage mensual se ha facturado con exito.
• monitoring.alert: se detecta una anomalia en una clave (pico 10x la media, salva de 429, etc.).

Estos eventos son propuestas; la lista definitiva se fijara tras el feedback de los primeros usuarios de la V1.

Alternativas temporales

Mientras tanto, usa uno de los siguientes patrones:

Polling dirigido del uso

El endpoint devuelve el mes actual y los 12 meses anteriores. Un cron diario basta para lanzar alertas sobre umbrales de consumo.

if response.credits_used_current / response.credits_limit > 0.8:
    send_slack_alert("API credits usage at 80%")

Monitorizacion en el cliente

En tu cliente, vigila las cabeceras X-Credits-Remaining y X-RateLimit-Remaining. Si alguna baja de un umbral critico, dispara una alerta casera.

Centinela programado

Programa un job que llame a un endpoint barato (por ejemplo POST /public/v1/resolve en un dominio canary) y registre status y cabeceras. Una serie de 401/403 inesperados indica un problema.

Que aportara la V2

Cuando los webhooks esten disponibles, podras:

• Registrar un endpoint HTTPS en el dashboard /account/webhooks.
• Elegir los eventos mediante casillas.
• Definir un secreto compartido para validar la firma HMAC de cada entrega.
• Consultar el dashboard de entregas exitosas, fallidas y en cola.
• Reintentar manualmente una entrega fallida.

El plan Starter deberia incluir 3 endpoints, Pro 10, Business y Enterprise ilimitados (sujeto a politica fair-use).

Suscripcion a anuncios

Para estar al tanto del lanzamiento:

• Suscribete al blog de CaptainDNS: los lanzamientos se anuncian en posts dedicados.
• Vigila el changelog de la API pública, actualizado en cada release.
• Los clientes Enterprise con account manager recibiran un pre-anuncio por email con acceso a la beta.

Mientras tanto, el quickstart y la referencia OpenAPI siguen siendo la mejor puerta de entrada para integrar hoy.