Riferimento OpenAPI interattivo
Questa pagina renderizza la specifica OpenAPI completa dell'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 questo riferimento
- Ricerca: la barra di ricerca di Scalar accetta nomi di endpoint, di schemi e 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 e compatibilità
La specifica è versionata in parallelo all'API. I breaking change sono elencati nel changelog e annunciati almeno 30 giorni prima del deployment. Le aggiunte non distruttive possono arrivare senza preavviso formale.
Il riferimento interattivo compare qui sotto: