Webhook: in arrivo a breve

I webhook permettono a CaptainDNS di inviare eventi ai tuoi sistemi in tempo reale, senza dover fare polling sulla API. Sono in sviluppo per la V2 della API pubblica e non sono ancora disponibili in produzione. Questa pagina spiega il piano è le alternative da usare nel frattempo.

Stato

• V1 (attuale): webhook non disponibili. La tabella webhook_endpoints esiste nel database, ma nessun endpoint di amministrazione ne emettitore backend la consuma.
• V2 (previsto): emissione di eventi, firma HMAC, retry con backoff esponenziale è dashboard di monitoraggio delle consegne.

Nessuna data ferma è stata ancora annunciata per la V2. L'avanzamento sarà comunicato nel changelog è sul blog CaptainDNS.

Casi d'uso previsti

Eventi in valutazione per la V2:

• api_key.rotated: una chiave è stata ruotata, quella vecchia entra in grace period.
• api_key.revoked: una chiave è stata revocata.
• api_key.expires_soon: una chiave si avvicina alla data di scadenza (tipicamente T-30).
• usage.threshold_reached: il consumo di crediti supera una soglia (80 %, 100 %, 120 %).
• usage.overage_reported: l'overage mensile è stato fatturato con successo.
• monitoring.alert: è rilevata un'anomalia su una chiave (picco dieci volte la media, raffica di 429, ecc.).

Questi eventi sono proposte; l'elenco definitivo sarà fissato dopo i feedback dei primi utenti V1.

Alternative temporanee

In attesa della V2, usa uno dei pattern seguenti:

Polling mirato dell'uso

L'endpoint restituisce il mese corrente è i 12 precedenti. Un cron giornaliero basta per attivare allerte su soglie di consumo.

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

Monitoraggio lato client

Nel tuo client, sorveglia gli header X-Credits-Remaining e X-RateLimit-Remaining. Se uno dei due scende sotto una soglia critica, attiva un allarme.

Sentinella programmata

Programma un job che chiama un endpoint economico (ad esempio POST /public/v1/resolve su un dominio canary) è logga status è header.

Cosa portera la V2

Con i webhook potrai:

• Registrare un endpoint HTTPS nella dashboard /account/webhooks.
• Scegliere gli eventi tramite checkbox.
• Definire un secret condiviso per verificare la firma HMAC di ogni consegna.
• Consultare il dashboard delle consegne riuscite, fallite è in retry.
• Riprovare manualmente una consegna fallita.

Il piano Starter dovrebbe includere 3 endpoint, Pro 10, Business ed Enterprise illimitati (soggetto a fair-use).

Iscrizione agli annunci

Per essere avvisato del lancio:

• Iscriviti al blog CaptainDNS: i lanci maggiori sono annunciati in post dedicati.
• Sorveglia il changelog della API pubblica.
• I clienti Enterprise con account manager riceveranno un preavviso via email con accesso alla beta.

Nel frattempo, il quickstart è la referenza OpenAPI restano la migliore porta d'accesso per integrare oggi.