API

Registrazione bonifico, verifica disponibilità, DNS e gestione nei vostri sistemi: ordini in blocco, rinnovi, un pannello di controllo per i vostri clienti.

API è il punto di accesso della macchina alle stesse operazioni offerte dall'area client. Quello che puoi fare su una pagina, puoi scriverlo.

RIPOSO HTTPS con risposte JSON

Chiavi API Creato e revocato nell'area clienti

Copertura completa Le stesse operazioni dell'area clienti

Controllabile Le chiamate vengono registrate sull'account

Di cosa si tratta

Gli endpoint sono raggruppati per risorsa - disponibilità, domini, nameserver, contatti, ordini e fatture - e restituiscono JSON.
L'autenticazione utilizza una chiave API generata nell'area clienti, che può essere revocata e sostituita in qualsiasi momento.
Usi tipici: registrazione in blocco, scansione delle scadenze, sincronizzazione dello stato del dominio nel tuo sistema, un pannello self-service per i clienti e flussi di lavoro dei certificati automatizzati.
Si applicano le stesse regole aziendali del web: un dominio non può essere registrato dal nulla e un trasferimento richiede comunque un dominio sbloccato e giorni 60.

Come funziona

01

Crea una chiave

Genera una chiave API nell'area client, limitata a ciò che deve fare.

02

Leggi la documentazione

Endpoint, parametri e forme di risposta.

03

Prova in piccolo

Prova gli endpoint di sola lettura o un paio di domini prima dell'automazione.

04

Vai in diretta con la registrazione

Aggiungi tentativi e registrazioni prima che tocchino la produzione.

Disponibilità e ricerca

Controlla più nomi contemporaneamente per il monitoraggio e la selezione.

Iscrizione e rinnovo

Ordina, rinnova e leggi lo stato dell'ordine.

DNS e server dei nomi

Invia modifiche in blocco a record e server dei nomi.

Gestione dei contatti

Leggere e aggiornare registrante, amministratore, tecnologia e fatturazione.

Ordini e fatture

Leggi ordini, fatture e stato dei pagamenti.

Rotazione della chiave

Revoca e sostituzione chiavi; mantenere ogni sistema sulla propria chiave.

Cosa copre API

Per risorsa

Risorsa	Cosa puoi fare
Domini	Verifica disponibilità, registrati, rinnova, leggi stato e scadenza
DNS	Leggi e imposta server dei nomi, mantieni i record DNS
Privacy e contatti	Imposta il livello di privacy, aggiorna tutti e quattro i ruoli dei contatti
Ordini e fatturazione	Leggi ordini, fatture e stato dei pagamenti
Conto	Leggi il saldo e i dettagli del conto di base

Cosa avere in atto prima di connettersi

Quattro piccole cose che salvano la maggior parte del debug

Saldo o metodo di pagamento funzionante: la registrazione e il rinnovo sono ordini reali e una chiamata fallirà nella fase di ordine senza fondi.
Nuovi tentativi e gestione degli errori: si verificano problemi di rete, limiti di velocità e ritardi upstream. Riprovare le letture idempotenti; per ordini inviare un riferimento univoco e verificare prima di scrivere nuovamente.
Logging: registra il riferimento, il dominio e il codice di risposta. Quando qualcosa viene contestato in seguito, quei registri sono l'unica prova che l'azione è avvenuta.
Privilegio minimo: non utilizzare una chiave scrivibile per un lavoro di sola lettura e assegnare a ciascun sistema la propria chiave in modo che una possa essere revocata senza danneggiare le altre.

Una chiave API equivale a una password dell'account. Conservalo in una variabile di ambiente lato server o in un gestore di segreti, mai nel codice front-end e mai in un repository.

Come lo usano le persone

Modelli comuni

Registratore di massa: invia una selezione per la registrazione e riscrivi i risultati nel tuo backend.
Rinnovi a scansione: recupera i domini prossimi alla scadenza ogni notte e crea i tuoi promemoria o attività di rinnovo.
Pannelli white label: consenti ai tuoi clienti di gestire i domini all'interno del tuo prodotto, senza accedere qui.
Riconciliazione: recupera i dati del dominio e dell'ordine in base a una pianificazione e confrontali con il tuo registro.

Cosa include ogni ordine

API gestione chiavi

Crea, revoca e separa le chiavi per scopo.

Documentazione

Endpoint, parametri e risposte.

Dominio ed endpoint DNS

Cerca, registra, rinnova, DNS e nameserver.

Endpoint di ordine e fatturazione

Ordini, fatture e stato dei pagamenti.

Cronologia delle chiamate

Registrato sull'account per la risoluzione dei problemi.

Supporto

Apri un ticket se un'integrazione si comporta in modo anomalo.

Domande comuni

È previsto un costo aggiuntivo per API?

Il API in sé non viene addebitato separatamente; paghi per le operazioni commerciali che esegue. Esiste un limite di velocità ragionevole per prevenire un uso accidentale o abusivo.

Esiste un SDK?

API è HTTPS e JSON standard, quindi funziona qualsiasi client HTTP. La documentazione include esempi di richieste che possono essere adattati direttamente.

Cosa succede se una chiave perde?

Revocarlo nell'area clienti e generarne uno nuovo. La revoca ha effetto immediato e le richieste che utilizzano la vecchia chiave vengono respinte.

Il test costa qualcosa?

Le chiamate di sola lettura non costano nulla. La registrazione e il rinnovo sono ordini reali e costano denaro, quindi convalida prima la logica su un numero limitato di domini.

API può gestire domini registrati altrove?

No. Opera sui domini di questo account, esattamente come l'area clienti.

Si prega di notare

Conservare le chiavi API sul server. Una chiave fornita nel codice del browser o in un pacchetto mobile è una chiave pubblicata.
Per ordinare gli endpoint, inviare un riferimento di richiesta univoco e verificare prima di scrivere, in modo che un nuovo tentativo di rete non venga registrato o addebitato due volte.