This web service allows you to purchase and manage .it domains.
This method lets you see the list of contacts associated with your domains
data | Array of strings |
success | boolean |
message | string |
error | integer |
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);
{- "data": [
- "AV-1386236438161",
- "AV-1485797541768",
- "AV-1485797620032",
- "AV-1386236511621",
- "LS7743"
], - "success": true,
- "message": "",
- "error": null
}
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.
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 |
object | |
success | boolean |
message | string |
error | integer |
{- "name": "Jane Doe",
- "org": "Jane Doe",
- "street": "Via xxx 2",
- "city": "Terni",
- "province": "TR",
- "postalcode": "05100",
- "countrycode": "IT",
- "voice": "+39.349xxxxxxx",
- "email": "[email protected]"
}
{- "data": {
- "handle": "AV-982654609"
}, - "message": "Greeting OK. Login OK. Create contact 'AV-982654609' created. Logout OK.",
- "success": true,
- "error": null
}
This method allows you to see the single contact related to the parameter passed in the path
handle required | string Default: "<string>" Example: LS7743 Contact Id |
object (Contact_Object) | |
success | boolean |
message | string |
error | integer |
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);
{- "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",
- "authinfo": "",
- "consentforpublishing": 1,
- "nationalitycode": "",
- "entitytype": 0,
- "regcode": "",
- "schoolcode": "",
- "timestamp": 1563193303
}, - "success": true,
- "message": "",
- "error": null
}
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
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' |
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 |
data | Array of any[ items ] |
success | boolean |
message | string |
error | integer |
{- "consentforpublishing": false
}
{- "data": [ ],
- "message": "Greeting OK. Login OK. Contact 'AV-982654609' is now up to date. Logout OK.",
- "success": true,
- "error": null
}