Domini .IT

L’unica API per attivare e gestire domini .it in tempo reale

Verifica, registra e rinnova un dominio .it direttamente tramite API

Tutte le informazioni di cui hai bisogno

Qui trovi qualche consiglio da prendere in considerazione per approcciare a questa API. Se preferisci forniamo esempi di codice, documentazione in OAS3, la possibilità di provare l'API dal vivo con la Swagger UI oppure importare l'intera collezione in Postman. Offriamo inoltre un ambiente di Sandbox dove puoi sperimentare tutte le API gratuitamente.

Utili consigli per iniziare con Domini .IT

Prendi il token nell'apposita sezione prima di cominciare.

Usa lo strumento online o generalo via API. Imposta una data di scadenza e aggiungi una serie di Scopes per limitare le possibli azioni permesse al token.

Domains (1.0.0)

Questo servizio web consente di acquistare e gestire i domini .it.

Contact

Chiamate per il controllo, la gestione e la registrazione dei contatti

Elenco dei contatti

Questo metodo consente di visualizzare l'elenco dei contatti associati ai propri domini

Authorizations:
bearerAuth

Responses

Response Schema: application/json
data
Array of strings
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://domains.altravia.com/contact");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Creare un nuovo contatto

Questo metodo consente di registrare un nuovo contatto nel sistema, che dovrà poi essere associato ai nuovi domini da acquistare. Se si desidera creare un contatto 'registrante', 'nationalitycode', 'entitytype' e 'regcode' sono obbligatori.

Authorizations:
bearerAuth
Request Body schema: application/json
name
required
string

Nome del contatto

org
required
string

Organizzazione di contatto

street
required
string

Indirizzo di contatto

city
required
string

Città di contatto

province
required
string

Provincia di contatto

postalcode
required
string

Codice postale del contatto

countrycode
required
string

Codice paese del contatto

voice
required
string

Numero di telefono del contatto; è accettato solo il formato internazionale:'+39.3502285745'.

email
required
string

Contatto e-mail

nationalitycode
string

Codice di nazionalità del contatto

entitytype
integer
Enum: 0 1 2 3 4 5 6 7

Tipo di entità di contatto: - 0: contatto non registrante; - 1: persone fisiche; - 2: società, ditte individuali; - 3: liberi professionisti; - 4: organizzazioni non profit; - 5: enti pubblici; - 6: altri soggetti; - 7: soggetti stranieri

regcode
string

Codice fiscale o partita IVA

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "name": "Jane Doe",
  • "org": "Jane Doe",
  • "street": "Via xxx 2",
  • "city": "Terni",
  • "province": "TR",
  • "postalcode": "05100",
  • "countrycode": "IT",
  • "voice": "+39.349xxxxxxx",
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "message": "Greeting OK. Login OK. Create contact 'AV-982654609' created. Logout OK.",
  • "success": true,
  • "error": null
}

Contatto singolo

Questo metodo consente di visualizzare il singolo contatto relativo al parametro passato nel percorso

Authorizations:
bearerAuth
path Parameters
handle
required
string
Example: LS7743

Id di contatto

Responses

Response Schema: application/json
object (Contact_Object)
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://domains.altravia.com/contact/%7Bhandle%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Aggiornare un contatto

Questo metodo consente di aggiornare le informazioni di contatto come nome, e-mail, privacy o voce. Se il contatto è un registrante e 'nationalitycode', 'entitytype', 'regcode' sono già compilati, non è più possibile modificarli.

Authorizations:
bearerAuth
Request Body schema: application/json
name
string

Nome del contatto

org
string

Organizzazione di contatto

street
string

Indirizzo di contatto

city
string

Città di contatto

province
string

Provincia di contatto

postalcode
string

Codice postale del contatto

countrycode
string

Codice paese del contatto

voice
string

Numero di telefono del contatto; è accettato solo il formato internazionale:'+39.3502285745'.

email
string

Contatto e-mail

consentforpublishing
boolean

Contatto privacy

nationalitycode
string

Codice di nazionalità del contatto

entitytype
integer
Enum: 0 1 2 3 4 5 6 7

Tipo di entità di contatto: - 0: contatto non registrante; - 1: persone fisiche; - 2: società, ditte individuali; - 3: liberi professionisti; - 4: organizzazioni non profit; - 5: enti pubblici; - 6: altri soggetti; - 7: soggetti stranieri

regcode
string

Codice fiscale o partita IVA

Responses

Response Schema: application/json
data
Array of any
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "consentforpublishing": false
}

Response samples

Content type
application/json
{
  • "data": [ ],
  • "message": "Greeting OK. Login OK. Contact 'AV-982654609' is now up to date. Logout OK.",
  • "success": true,
  • "error": null
}

Eliminare un contatto

Questo metodo consente di eliminare un contatto all'interno del sistema.

Authorizations:
bearerAuth

Responses

Response Schema: application/json
data
Array of any
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_easy_setopt(hnd, CURLOPT_URL, "https://domains.altravia.com/contact/%7Bhandle%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [ ],
  • "message": "Greeting OK. Login OK. Contatc 'AV-1485837405' not available, trying to delete... OK. Logout OK.",
  • "success": true,
  • "error": null
}

Domain

Richieste per il controllo, la gestione e la registrazione dei domini

Controllare il dominio

Questo metodo consente di sapere se un dominio è disponibile

Authorizations:
bearerAuth
path Parameters
domain
required
string
Example: altravia.it

nome di dominio

Responses

Response Schema: application/json
data
Array of strings
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://domains.altravia.com/check/%7Bdomain%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [ ],
  • "success": true,
  • "message": "Greeting OK. Login OK. Domain 'provasitotest.it' is available. Logout OK.",
  • "error": null
}

Elenco dei vostri domini

Questo metodo consente di visualizzare l'elenco dei domini registrati dal proprio profilo.

Authorizations:
bearerAuth

Responses

Response Schema: application/json
data
Array of strings
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://domains.altravia.com/domain");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Registrare un nuovo dominio

Questo metodo consente di registrare un nuovo dominio o di trasferirne uno esistente. Per l'aggiunta di un nuovo dominio sono richiesti: 'domain', 'registrant', 'admin', 'tech', 'dns'; per il trasferimento di un dominio esistente sono obbligatori: 'domain', 'authinfo'.

Authorizations:
bearerAuth
Request Body schema: application/json
domain
required
string

Nome del dominio

authinfo
required
string

Codice di autorizzazione del dominio

registrant
required
string

Identificatore del registrante

admin
required
string

Identificatore amministratore

tech
required
Array of strings
dns
required
Array of strings

Responses

Response Schema: application/json
data
Array of any
success
boolean
message
string
price
integer
error
integer

Request samples

Content type
application/json
{
  • "domain": "pagabolloaci.it",
  • "registrant": "AV-1463493248976",
  • "admin": "LS7743",
  • "tech": [
    ],
  • "dns": [
    ]
}

Response samples

Content type
application/json
{
  • "data": [ ],
  • "message": "Greeting OK. Login OK. Domain 'pagabolloaci.it' is available. Domain 'pagabolloaci.it' created. Logout OK.",
  • "price": 10,
  • "success": true,
  • "error": null
}

Dominio singolo

Questo metodo consente di visualizzare il singolo dominio relativo al parametro passato nel percorso

Authorizations:
bearerAuth
path Parameters
domain
required
string
Example: altravia.it

Nome del dominio

Responses

Response Schema: application/json
object (Domain_Object)
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://domains.altravia.com/domain/%7Bdomain%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Aggiornare un dominio

Questo metodo consente di aggiornare informazioni sul dominio come registrant, admin, tech o dns. Sia il 'registrant' che il 'dns' devono essere aggiornati da soli e non in presenza di altri parametri, nemmeno insieme.

Authorizations:
bearerAuth
Request Body schema: application/json
registrant
string

Identificazione del nuovo dichiarante

admin
string

Identificazione del nuovo amministratore

tech
Array of strings
dns
Array of strings

Responses

Response Schema: application/json
data
Array of any
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "dns": [
    ]
}

Response samples

Content type
application/json
{
  • "data": [ ],
  • "message": "Greeting OK. Login OK. Adding NS: ns1.altravia.com. Adding NS: ns2.altravia.com. Adding NS: ns3.altravia.com. Domain 'yingyang.it' is now up to date. Logout OK.",
  • "success": true,
  • "error": null
}

Eliminare un dominio

Questo metodo consente di eliminare un dominio

Authorizations:
bearerAuth

Responses

Response Schema: application/json
data
Array of any
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_easy_setopt(hnd, CURLOPT_URL, "https://domains.altravia.com/domain/%7Bdomain%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [ ],
  • "message": "Greeting OK. Login OK. Domain 'urbegas.it' not available, trying to delete... OK. Logout OK.",
  • "success": true,
  • "error": null
}

Ottenere il dichiarante

Questo metodo mostra chi è il contatto del registrante del vostro dominio.

Authorizations:
bearerAuth
path Parameters
domain
required
string
Example: altravia.it

nome di dominio

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://domains.altravia.com/domain/%7Bdomain%7D/registrant");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Ottenere l'amministratore

Questo metodo mostra chi è il contatto di amministrazione del vostro dominio

Authorizations:
bearerAuth
path Parameters
domain
required
string
Example: altravia.it

nome di dominio

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://domains.altravia.com/domain/%7Bdomain%7D/admin");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Ottenere la tecnologia

Questo metodo mostra chi è il contatto tecnico del proprio dominio

Authorizations:
bearerAuth
path Parameters
domain
required
string
Example: altravia.it

nome di dominio

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://domains.altravia.com/domain/%7Bdomain%7D/tech");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Cancellare la tecnologia

Questo metodo consente di eliminare un tecnico da un dominio specifico.

Authorizations:
bearerAuth
path Parameters
domain
required
string
Example: altravia.it

nome di dominio

handle
required
string
Example: AV-1463493248976

ID tecnico

Responses

Response Schema: application/json
data
Array of strings
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_easy_setopt(hnd, CURLOPT_URL, "https://domains.altravia.com/domain/%7Bdomain%7D/tech/%7Bhandle%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [ ],
  • "success": true,
  • "message": "Greeting OK. Login OK. Removing TECH-C: LS7743. TECH-C LS7743 is deleted. Logout OK.",
  • "error": null
}