Riferimento OpenAPI interattivo
Questa pagina renderizza la specifica OpenAPI completa della API pubblica CaptainDNS. Usa il sommario a sinistra per navigare tra gli endpoint per categoria (DNS, Mail, Web, Text). Ogni endpoint mostra il suo schema di richiesta, le risposte possibili e un esempio di chiamata.
Come usare questa referenza
- Ricerca: la barra di ricerca di Scalar accetta nomi di endpoint, di schemi è di tag.
- Schemi: le risposte sono collegate agli schemi globali, nella sezione
Components. - Prova la richiesta: per gli endpoint pubblici, puoi incollare la tua chiave API ed eseguire una chiamata direttamente dal browser. Attenzione, consuma crediti.
- Download: il pulsante
Downloadin alto a destra permette di scaricare la specifica come JSON o YAML.
Promemoria prima di chiamare
- Autenticazione: header
Authorization: Bearer cdns_live_.... Vedi la guida all'autenticazione. - Idempotenza: header
Idempotency-Keyopzionale, vedi la guida all'idempotenza. - Rate limiting: rispetta
Retry-Aftersui 429, vedi rate limiting. - Crediti: sorveglia
X-Credits-Remaining, vedi il modello di crediti.
Versioni è compatibilita
La specifica è versionata in parallelo al API. I cambiamenti di rottura sono elencati nel changelog è annunciati almeno 30 giorni prima del deployment. Le aggiunte non distruttive possono arrivare senza preavviso formale.
La referenza interattiva compare qui sotto: