Domains (1.0.0)

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

This web service allows you to purchase and manage .it domains.

First time here? Generate a new access token

Contact

Calls for checking, managing and recording contacts

List of your contacts

This method lets you see the list of contacts associated with your domains

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

200
404

Content type

application/json

{"data": ["AV-1386xxxxx161",
"AV-xxxx797541768",
"AV-1485797xxxx32",
"AV-13xxx3651xx21",
"Lxxx43"
],
"success": true,
"message": "",
"error": null
}

Create new contact

This method allows you to register a new contact in the system, which you will then need to associate with the new domains to be purchased. If you want to create a 'registrant' contact, 'nationalitycode', 'entitytype' and 'regcode' are mandatory.

Authorizations:

bearerAuth

Request Body schema: application/json

name required	string Default: "<string>" Contact name
org required	string Default: "<string>" Contact organization
street required	string Default: "<string>" Contact address
city required	string Default: "<string>" Contact city
province required	string Default: "<string>" Contact province
postalcode required	string Default: "<string>" Contact postal code
countrycode required	string Default: "<string>" Contact country code
voice required	string Default: "<string>" Contact telephone number; only this international format accepted:'+39.3502285745'
email required	string Default: "<string>" Contact email
nationalitycode	string Default: "<string>" Contact nationality code
entitytype	integer Default: "<integer>" Enum: 0 1 2 3 4 5 6 7 Contact entity type: - 0: non-registering contact; - 1: natural persons; - 2: companies, sole proprietorships; - 3: freelancers; - 4: non-profit organizations; - 5: public entities; - 6: other subjects; - 7: foreign subjects
regcode	string Default: "<string>" Tax code or VAT number

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

200
406
412
417
422

Content type

application/json

{"data": {"handle": "AV-9xxx54609"
},
"message": "Greeting OK. Login OK. Create contact 'AV-9xxx54609' created. Logout OK.",
"success": true,
"error": null
}

Single contact

This method allows you to see the single contact related to the parameter passed in the path

Authorizations:

bearerAuth

path Parameters

handle

required

string

Default: "<string>"

Example: DD7766

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

200
404

Content type

application/json

{"data": {"status": ["ok",
"linked"
],
"handle": "DD7766",
"name": "Lxxa Sxxxxi",
"org": "Altxxxia srl",
"street": "Via A. Mixxxvoi 683",
"street2": "",
"street3": "",
"city": "Roma",
"province": "RM",
"postalcode": "00178",
"countrycode": "IT",
"voice": "xxxxxxxx",
"fax": "xxxxxxx",
"email": "[email protected]",
"authinfo": "",
"consentforpublishing": 1,
"nationalitycode": "",
"entitytype": 0,
"regcode": "",
"schoolcode": "",
"owner": "[email protected]",
"timestamp": 1563193303
},
"success": true,
"message": "",
"error": null
}

Update a contact

This method allows you to update contact information like name, email, privacy or voice. If the contact is a registrant and 'nationalitycode', 'entitytype', 'regcode' are already filled in, it is no longer possible to change them

Authorizations:

bearerAuth

Request Body schema: application/json

name	string Default: "<string>" Contact name
org	string Default: "<string>" Contact organization
street	string Default: "<string>" Contact address
city	string Default: "<string>" Contact city
province	string Default: "<string>" Contact province
postalcode	string Default: "<string>" Contact postal code
countrycode	string Default: "<string>" Contact country code
voice	string Default: "<string>" Contact telephone number; only this international format accepted:'+39.3502285745'
email	string Default: "<string>" Contact email
consentforpublishing	boolean Default: "<boolean>" Contact privacy
nationalitycode	string Default: "<string>" Contact nationality code
entitytype	integer Default: "<integer>" Enum: 0 1 2 3 4 5 6 7 Contact entity type: - 0: non-registering contact; - 1: natural persons; - 2: companies, sole proprietorships; - 3: freelancers; - 4: non-profit organizations; - 5: public entities; - 6: other subjects; - 7: foreign subjects
regcode	string Default: "<string>" Tax code or VAT number

Responses

Response Schema: application/json

data	Array of any[ items ]
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-9826xxx609' is now up to date. Logout OK.",
"success": true,
"error": null
}

Delete a contact

This method allows you to delete a contact within the system

Authorizations:

bearerAuth

Responses

Response Schema: application/json

data	Array of any[ items ]
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-14xxx37405' not available, trying to delete...  OK. Logout OK.",
"success": true,
"error": null
}

Domain

Calls for the control, management and registration of domains

Check domain

This method lets you know if a domain is available

Authorizations:

bearerAuth

path Parameters

domain

required

string

Default: "<string>"

Example: provasitotest.it

domain name

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

200
400
412

Content type

application/json

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

List of your domains

This method allows you to see the list of domains registered by your profile

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

200
404

Content type

application/json

{"data": ["miosito.it",
"tuosito.it",
"sitox.it",
"sitoy.it"
],
"success": true,
"message": "",
"error": null
}

Register a new domain

This method allows you to register a new domain or transfer an existing one. For the addition of a new domain are required: 'domain', 'registrant', 'admin', 'tech', 'dns'; for the transfer of an existing domain are mandatory: 'domain', 'authinfo'

Authorizations:

bearerAuth

Request Body schema: application/json

domain required	string Default: "<string>" Domain name
authinfo required	string Default: "<string>" Domain authorization code
registrant required	string Default: "<string>" Registrant identifier
admin required	string Default: "<string>" Admin identifier
tech required	Array of strings <= 2 items
dns required	Array of strings <= 2 items

Responses

Response Schema: application/json

data	Array of any[ items ]
success	boolean
message	string
price	integer
error	integer

Request samples

Content type

application/json

{"domain": "miosito.it",
"registrant": "AV-xxx3493248xxx",
"admin": "xx77xx",
"tech": ["AV-14xx49324xxx"
],
"dns": ["dns1.tuosito.com",
"dns2.tuosito.com",
"dns3.tuosito.com"
]
}

Response samples

Content type

application/json

{"data": [ ],
"message": "Greeting OK. Login OK. Domain 'miosito.it' is available. Domain 'miosito.it' created. Logout OK.",
"price": 10,
"success": true,
"error": null
}

Single domain

This method allows you to see the single domain related to the parameter passed in the path

Authorizations:

bearerAuth

path Parameters

domain

required

string

Default: "<string>"

Example: miosito.it

Domain name

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

200
404

Content type

application/json

{"data": {"status": ["ok"
],
"domain": "miosito.it",
"ns": ["dns1.tuosito.com",
"dns2.tuosito.com",
"dns3.tuosito.com"
],
"registrant": "AV-xxxxxxxxx",
"admin": "AV-xxxxxxxx",
"tech": "AV-xxxxxxxxx",
"authinfo": "xxxxxxxxxx",
"crDate": "2002-11-14T00:00:00.000+01:00",
"exDate": "2020-02-21T23:59:59.000+01:00",
"dnssec": [ ],
"owner": "[email protected]",
"timestamp": 1565354292,
"renewal_date": "09/09/2020"
},
"success": true,
"message": "",
"error": null
}

Update a domain

This method allows you to update domain information like registrant, admin, tech or dns. Both the 'registrant' and the 'dns' must be updated alone and not in the presence of other parameters, not even together

Authorizations:

bearerAuth

Request Body schema: application/json

registrant	string Default: "<string>" Identification of the new registrant
admin	string Default: "<string>" Identification of the new admin
tech	Array of strings <= 2 items
dns	Array of strings <= 2 items

Responses

Response Schema: application/json

data	Array of any[ items ]
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{"dns": ["dns1.tuosito.com",
"dns2.tuosito.com",
"dns3.tuosito.com"
]
}

Response samples

Content type

application/json

{"data": [ ],
"message": "Greeting OK. Login OK. Adding NS: ns1.tuosito.com. Adding NS: ns2.tuosito.com. Adding NS: ns3.tuosito.com. Domain 'miosito.it' is now up to date. Logout OK.",
"success": true,
"error": null
}

Delete a domain

This method allows you to delete a domain

Authorizations:

bearerAuth

Responses

Response Schema: application/json

data	Array of any[ items ]
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

200
400
404
412
417

Content type

application/json

{"data": [ ],
"message": "Greeting OK. Login OK. Domain 'tuosito.it' not available, trying to delete...  OK. Logout OK.",
"success": true,
"error": null
}

Get the registrant

This method shows you who the registrant contact of your domain is

Authorizations:

bearerAuth

path Parameters

domain

required

string

Default: "<string>"

Example: miosito.it

domain name

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

200
404

Content type

application/json

{"data": {"registrant": "AV-146xxx248xx6"
},
"success": true,
"message": "",
"error": null
}

Get the admin

This method shows you who the admin contact of your domain is

Authorizations:

bearerAuth

path Parameters

domain

required

string

Default: "<string>"

Example: miosito.it

domain name

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

200
404

Content type

application/json

{"data": {"admin": "AV-1xxx4932xx976"
},
"success": true,
"message": "",
"error": null
}

Get the tech

This method shows you who the tech contact of your domain is

Authorizations:

bearerAuth

path Parameters

domain

required

string

Default: "<string>"

Example: miosito.it

domain name

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

200
404

Content type

application/json

{"data": {"tech": "AV-1xxx4932xxxx"
},
"success": true,
"message": "",
"error": null
}

Delete the tech

This method allows you to delete a tech from a specific domain

Authorizations:

bearerAuth

path Parameters

domain required	string Default: "<string>" Example: miosito.it domain name
handle required	string Default: "<string>" Example: AV-1xxx4932xxx76 Tech id

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

200
400
404
412
417

Content type

application/json

{"data": [ ],
"success": true,
"message": "Greeting OK. Login OK. Removing TECH-C: xxx743. TECH-C xxx743 is deleted. Logout OK.",
"error": null
}