API e sviluppatori
Ultimo aggiornamento 27/10/2026
API espone le stesse operazioni dell'area client, su HTTPS con risposte JSON. Tutto ciò che puoi fare su un dominio nel browser, puoi crearlo tramite script.
Prendi prima una chiave
Crea una chiave API nell'area client. Utilizza una chiave separata per sistema in modo che la revoca di una non rompa le altre, e conservala su un server: una chiave nel codice del browser o in un bundle mobile è una chiave che hai pubblicato.
Archivialo in una variabile di ambiente o in un gestore di segreti, mai in un repository.
Cosa puoi fare
Domini: verifica disponibilità, registra, rinnova, leggi stato e scadenza.
DNS: leggere e impostare i nameserver e conservare i record DNS.
Privacy e contatti: imposta il livello di privacy e aggiorna i record del registrante, dell'amministratore, della tecnologia e della fatturazione.
Ordini e fatturazione: leggi ordini, fatture e stato dei pagamenti.
Conto: leggi il saldo e i dettagli del conto di base.
Progetta per il fallimento prima che ne abbia bisogno
Si verificano limiti di velocità, timeout della rete e ritardi upstream. Riprovare liberamente le letture idempotenti. Per tutto ciò che effettua un ordine, invia un riferimento di richiesta univoco e controllalo prima di scrivere nuovamente, altrimenti una chiamata ripetuta può registrare lo stesso dominio due volte.
Registra il riferimento, il dominio e il codice di risposta per ogni chiamata. Quando successivamente qualcosa viene contestato, quei registri sono l'unica prova che è stata intrapresa un'azione.
Compromessi a cui pensare
La registrazione e il rinnovo sono ordini reali e costano denaro reale: mantieni un saldo o un metodo di pagamento funzionante e testa il flusso su un numero limitato di domini prima di puntare un sistema automatizzato su un lotto di grandi dimensioni.
Quando qualcosa sembra sbagliato
Leggi il corpo della risposta: contiene il motivo, non solo un codice di stato. Verifica poi che la chiave sia ancora attiva e che il dominio sia in uno stato che consenta l'operazione. Se la risposta non è ancora chiara, apri un ticket con il riferimento della richiesta e l'orario della chiamata.