Run with Postman

Domains (1.0.0)

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

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:

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
}

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:
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",
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "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:
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

Content type
application/json
{
  • "data": {
    },
  • "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:
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:

Responses

Response Schema: application/json
data
Array of any[ items ]
success
boolean
message
string