.it Domains

  1. Home
  2. API Library
  3. .it Domains
The only API to activate and manage .it domains in real time

Check, register and renew an .it domain directly via API

All the knowledge you need

Here you can find some advice to consider to approach this API. If you prefer, we provide code samples, OAS3 documentation, the ability to try the API live via the Swagger UI or import the entire collection into Postman. We also offer a Sandbox environment where you can experiment with all kinds of requests completely free of charge.

Useful tips to start with .it Domains

Get the token in the appropriate section before you start.

Use the the online tool or generate it via API. Set the expire date, a usefull name and now add a bunch of scopes to limit the possible actions your token can do.
Read more on oauth API Manage my tokens
API docs by Redocly

Domains (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

Ce service web vous permet d'acheter et de gérer des domaines .it.

Vous venez pour la première fois ? Générer un nouveau jeton d'accès

Contact

Appels pour la vérification, la gestion et la saisie des contacts

Liste de vos contacts

Cette méthode vous permet d'afficher la liste des contacts associés à vos domaines.

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
}

Créer un nouveau contact

Cette méthode vous permet d'enregistrer un nouveau contact dans le système, que vous devrez ensuite associer aux nouveaux domaines à acquérir. Si vous souhaitez créer un contact "registrant", "nationalitycode", "entitytype" et "regcode" sont obligatoires.

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

Nom de la personne de contact

org
required
string

Contact Organisation

street
required
string

Adresse de contact

city
required
string

Contact Ville

province
required
string

Contact Province

postalcode
required
string

Code postal de la personne de contact

countrycode
required
string

Code pays de la personne de contact

voice
required
string

Numéro de téléphone de la personne de contact ; seul ce format international est accepté:'+39.3502285745'.

email
required
string

Contact E-mail

nationalitycode
string

Code de nationalité de la personne de contact

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

Type de contact : - 0 : contact non enregistré ; - 1 : personnes physiques ; - 2 : sociétés, entreprises individuelles ; - 3 : professions libérales ; - 4 : organisations à but non lucratif ; - 5 : institutions publiques ; - 6 : autres sujets ; - 7 : sujets étrangers

regcode
string

Numéro d'identification fiscale ou numéro de TVA

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",
  • "email": "[email protected]"
}

Response samples

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

Contact facile

Cette méthode permet de voir le contact individuel associé au paramètre passé dans le chemin d'accès

Authorizations:
bearerAuth
path Parameters
handle
required
string
Example: LS7743

Contact Id

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
}

Mettre à jour un contact

Cette méthode permet de mettre à jour les informations de contact telles que le nom, l'e-mail, la sphère privée ou la voix. Si le contact est un inscrit et que "nationalitycode", "entitytype" et "regcode" sont déjà remplis, ils ne peuvent plus être modifiés.

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

Nom de la personne de contact

org
string

Contact Organisation

street
string

Adresse de contact

city
string

Contact Ville

province
string

Contact Province

postalcode
string

Code postal de la personne de contact

countrycode
string

Code pays de la personne de contact

voice
string

Numéro de téléphone de la personne de contact ; seul ce format international est accepté:'+39.3502285745'.

email
string

Contact E-mail

consentforpublishing
boolean

Contact Protection des données

nationalitycode
string

Code de nationalité de la personne de contact

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

Type de contact : - 0 : contact non enregistré ; - 1 : personnes physiques ; - 2 : sociétés, entreprises individuelles ; - 3 : professions libérales ; - 4 : organisations à but non lucratif ; - 5 : institutions publiques ; - 6 : autres sujets ; - 7 : sujets étrangers

regcode
string

Numéro d'identification fiscale ou numéro de TVA

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
}

Supprimer un contact

Cette méthode permet de supprimer un contact dans le système.

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

Demande le contrôle, la gestion et l'enregistrement des domaines

Vérifier le domaine

Cette méthode vous permet de déterminer si un domaine est disponible

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

Nom de domaine

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
}

Liste de vos domaines

Cette méthode vous permet de consulter la liste des domaines enregistrés par votre profil.

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
}

Enregistrer un nouveau domaine

Cette méthode permet d'enregistrer un nouveau domaine ou de transférer un domaine existant. Pour ajouter un nouveau domaine, il faut : 'domain', 'registrant', 'admin', 'tech', 'dns' ; pour transférer un domaine existant, il faut : 'domain', 'authinfo'.

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

Nom de domaine

authinfo
required
string

Code d'autorisation de domaine

registrant
required
string

Identification du déclarant

admin
required
string

Identifiant Admin

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
}

Single domain

Cette méthode permet de voir le domaine unique qui se réfère au paramètre passé dans le chemin d'accès

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

Nom de domaine

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
}

Mettre à jour un domaine

Cette méthode permet de mettre à jour les informations de domaine telles que registrant, admin, tech ou dns. Tant "registrant" que "dns" doivent être mis à jour seuls, et non pas en combinaison avec d'autres paramètres, même ensemble.

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

Identification du nouveau déclarant

admin
string

Identification du nouvel administrateur

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
}

Supprimer un domaine

Cette méthode permet de supprimer un domaine

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
}

Obtenir le déclarant

Cette méthode vous indique qui est le contact du registrant de votre domaine

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

Nom de domaine

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
}

Obtenir l'admin

Cette méthode vous indique qui est le contact admin de votre domaine

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

Nom de domaine

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
}

Obtenir la technique

Cette méthode vous indique qui est le contact technique pour votre domaine

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

Nom de domaine

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
}

Effacer la technique

Cette méthode permet de supprimer un tech d'un domaine donné.

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

Nom de domaine

handle
required
string
Example: AV-1463493248976

Nom technique

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
}
Web Service Revision: 2.0.0