API Call: Registrazione dominio (Reseller domini)

Questa chiamata consente di inviare un comando per la registrazione di un nuovo dominio. Se ci sono stati errori puoi inviare la richiesta di registrazione più volte, i nuovo dati andranno a correggere i dati inviati con le richieste precedenti. Non c’è un limite nel numero di volte che puoi inviare la stessa richiesta di registrazione per lo stesso dominio.

Parametri della richiesta

Parametro	Tipo	Descrizione	Richiesto
domain	stringa	Il nome del dominio da registrare	Richiesto
firstname	stringa	Il nome del registrante	Richiesto
lastname	stringa	Il cognome del registrante	Richiesto
companyname	stringa	Il nome della società. Richiesto solo se il dominio viene registrato per una società	Opzionale
contactemail	stringa	L’email del registrante	Richiesto
address1	stringa	La prima riga dell’indirizzo del registrante	Richiesto
address2	stringa	La seconda riga dell’indirizzo del registrante	Opzionale
city	stringa	La città dell’indirizzo del registrante	Richiesto
state	stringa	Lo stato dell’indirizzo del registrante. Nel caso di indirizzo in Italia la sigla della provincia	Richiesto
postcode	stringa	Il codice di avviamento postale dell’indirizzo del registrante	Richiesto
country	stringa	La nazione dell’indirizzo del registrante, due lettere	Richiesto
phonenumber	stringa	Il numero di telefono del registrante nel formato +39.0000000000	Richiesto
idnLanguage	stringa	Se si tratta di un dominio IDN specificare la lingua IDN	Opzionale
regperiod	INT	Il periodo di registrazione espresso in anni, da 1 a 10 (compresi)	Richiesto
nameserver1	stringa	Il primo namservers del dominio, es: ns1.domino.it	Richiesto
nameserver2	stringa	Il secondo namservers del dominio, es: ns2.domino.it	Richiesto
nameserver3	stringa	Eventuale nameserver aggiuntivo	Opzionale
nameserver4	stringa	Eventuale nameserver aggiuntivo	Opzionale
nameserver5	stringa	Eventuale nameserver aggiuntivo	Opzionale
idprotection	bool	false se non si vuole attivare la privacy WHOIS, vero se si vuole attivare	Richiesto
additionalfields	Array	Un array contenente i campi addizionali per i domini. Dettagli nella tabella sotto	Opzionale

Additional fields

Alcuni domini hanno dei campi aggiuntivi richiesti, necessari per la registrazione.

Estensione	Campo Aggiuntivo	Descrizione
.it	entity	Un numero intero da 1 a 7 come indicato dal nic: 1 Persone fisiche italiane e straniere 2 Società 3 Imprese individuali, liberi professionisti / ordini professionali 4 Enti no-profit 5 Enti pubblici 6 Altri soggetti 7 Soggetti stranieri equiparati ai precedenti escluso le persone fisiche
.it	taxid	Codice fiscale se “entity” è una persona fisica italiana. Numero del documento se persona fisica straniera. Partita IVA (solo numeri) in tutti gli altri casi, nel caso di enti no-profit può essere n.a. (se non hanno partita IVA o codice fiscale numerico)
.it	whois	true o false a seconda che si vogliano pubblicare o meno i dati personali. La scelta è possibile solo per le persone fisiche, per tutti gli altri “entity” deve essere necessariamente su true
.it	itterms	Accettazione dei termini del nic.it, è obbligatorio accettare i termini

Parametri della risposta

Parametro	Tipo	Descrizione
result	stringa	Il risultato dell’operazione: success o error
domain	stringa	Il dominio che siamo registrando
message	stringa	Il messaggio, di successo o di errore

Esempio di richiesta (PHP cUrl)

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://my.supporthost.com/domainapi.php/domain/register',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "domain": "xxxxx.it",
    "eppcode": "xxxxxx",
    "firstname": "xxxxxx",
    "lastname": "xxxxxx",
    "companyname": "xxxxxx",
    "contactemail": "[email protected]",
    "address1": "xxxxxx 123",
    "address2": "xxxxxx",
    "city": "xxxxxx",
    "state": "RM",
    "postcode": "12345",
    "country": "IT",
    "phonenumber": "+39.0000000000",
    "idnLanguage": "",
    "regperiod": "0",
    "nameserver1": "ns1.domain.com",
    "nameserver2": "ns2.domain.com",
    "idprotection": "",
    "additionalfields": {
        "entity": "1",
        "taxid": "xxxxxx",
        "itterms": "on",
        "whois": "on"
    }
}',
  CURLOPT_HTTPHEADER => array(
    'X-Email: your_email',
    'X-Api-Key: your_apikey'
  ),
));

$response = curl_exec($curl);

curl_close($curl);

Esempio di risposta (JSON)

{
    "result": "success",
    "domain": "supporthost.it",
    "message": "Domain registered successfully"
}

Risposte di errore

Connection refused from unauthorized host. IP xxx.xxx.xxx.xxx is NOT allowed to access your account
Invalid email or not a reseller.
Invalid API key.
Validazioni: per tutti i campi obbligatori eseguiamo della validazioni, se la validazione non viene superata ricevi un messaggio di errore.
The domain is not available for registration
Domain is already pending in your account. Go to the SupportHost clientarea and pay the invoice to register it
Domain is already in your account
Errori da parte del registro: se il registro restituisce un errore lo riportiamo nell’errore della registrazione

Risparmia con i saldi estivi!