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-1386236438161",
"AV-1485797541768",
"AV-1485797620032",
"AV-1386236511621",
"LS7743"
],
"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-982654609"
},
"message": "Greeting OK. Login OK. Create contact 'AV-982654609' 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: 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

200
404

Content type

application/json

{"data": {"status": ["ok",
"linked"
],
"handle": "LS7743",
"name": "Lxxa Sxxxxi",
"org": "Altravia srl",
"street": "Via A. Millevoi 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-982654609' 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