IT-Domains

  1. Home
  2. API Library
  3. IT-Domains
Registrierung von IT-Domains über API

Prüfen, registrieren und erneuern Sie eine .it-Domain direkt über eine API

All das Wissen, das Sie benötigen

Hier finden Sie einige Ratschläge, die Sie berücksichtigen sollten, um sich dieser API zu nähern. Wenn Sie möchten, bieten wir Code-Beispiele, OAS3-Dokumentation, die Möglichkeit, die API live über Swagger UI auszuprobieren oder die gesamte Sammlung in Postman zu importieren. Wir bieten auch eine Sandbox-Umgebung an, in der Sie kostenlos mit allen Arten von Anfragen experimentieren können.

Nützliche Tipps für den Einstieg IT-Domains

Holen Sie sich das Token im entsprechenden Abschnitt, bevor Sie beginnen.

Verwenden Sie das Online-Tool oder generieren Sie es über die API. Legen Sie das Ablaufdatum, einen nützlichen Namen fest und fügen Sie jetzt eine Vielzahl von Scopes hinzu, um die möglichen Aktionen Ihres Tokens zu begrenzen.
Lesen Sie mehr über die OAuth-API Meine Tokens verwalten
API docs by Redocly

Domains (1.0.0)

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

Dieser Webservice ermöglicht es Ihnen, .it-Domains zu kaufen und zu verwalten.

Zum ersten Mal hier? Generieren Sie ein neues Zugangstoken

Contact

Anrufe zur Überprüfung, Verwaltung und Erfassung von Kontakten

Liste Ihrer Kontakte

Mit dieser Methode können Sie die Liste der Kontakte anzeigen, die mit Ihren Domänen verbunden sind

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
}

Neuen Kontakt erstellen

Mit dieser Methode können Sie einen neuen Kontakt im System registrieren, den Sie dann mit den neu zu erwerbenden Domains verknüpfen müssen. Wenn Sie einen "Registrant"-Kontakt erstellen möchten, sind "nationalitycode", "entitytype" und "regcode" obligatorisch.

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

Name der Kontaktperson

org
required
string

Kontakt Organisation

street
required
string

Kontaktadresse

city
required
string

Kontakt Stadt

province
required
string

Kontakt Provinz

postalcode
required
string

Postleitzahl des Ansprechpartners

countrycode
required
string

Ländercode der Kontaktperson

voice
required
string

Telefonnummer der Kontaktperson; nur dieses internationale Format wird akzeptiert:'+39.3502285745'

email
required
string

Kontakt E-Mail

nationalitycode
string

Nationalitätscode des Ansprechpartners

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

Art der Kontaktperson: - 0: nicht registrierter Kontakt; - 1: natürliche Personen; - 2: Unternehmen, Einzelunternehmen; - 3: Freiberufler; - 4: gemeinnützige Organisationen; - 5: öffentliche Einrichtungen; - 6: sonstige Subjekte; - 7: ausländische Subjekte

regcode
string

Steuernummer oder Umsatzsteueridentifikationsnummer

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
}

Einfacher Kontakt

Mit dieser Methode können Sie den einzelnen Kontakt sehen, der mit dem im Pfad übergebenen Parameter zusammenhängt

Authorizations:
bearerAuth
path Parameters
handle
required
string
Example: LS7743

Kontakt 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
}

Einen Kontakt aktualisieren

Mit dieser Methode können Sie Kontaktinformationen wie Name, E-Mail, Privatsphäre oder Stimme aktualisieren. Wenn der Kontakt ein Registrant ist und "nationalitycode", "entitytype" und "regcode" bereits ausgefüllt sind, können sie nicht mehr geändert werden

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

Name der Kontaktperson

org
string

Kontakt Organisation

street
string

Kontaktadresse

city
string

Kontakt Stadt

province
string

Kontakt Provinz

postalcode
string

Postleitzahl des Ansprechpartners

countrycode
string

Ländercode der Kontaktperson

voice
string

Telefonnummer der Kontaktperson; nur dieses internationale Format wird akzeptiert:'+39.3502285745'

email
string

Kontakt E-Mail

consentforpublishing
boolean

Kontakt Datenschutz

nationalitycode
string

Nationalitätscode der Kontaktperson

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

Art der Kontaktperson: - 0: nicht registrierter Kontakt; - 1: natürliche Personen; - 2: Unternehmen, Einzelunternehmen; - 3: Freiberufler; - 4: gemeinnützige Organisationen; - 5: öffentliche Einrichtungen; - 6: sonstige Subjekte; - 7: ausländische Subjekte

regcode
string

Steuernummer oder Umsatzsteueridentifikationsnummer

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
}

Einen Kontakt löschen

Mit dieser Methode können Sie einen Kontakt innerhalb des Systems löschen

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

Fordert die Kontrolle, Verwaltung und Registrierung von Domains

Bereich prüfen

Mit dieser Methode können Sie feststellen, ob eine Domäne verfügbar ist

Authorizations:
bearerAuth
path Parameters
domain
required
string
Example: altravia.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

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

Liste Ihrer Domains

Mit dieser Methode können Sie die Liste der von Ihrem Profil registrierten Domains einsehen

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
}

Eine neue Domain registrieren

Diese Methode ermöglicht es Ihnen, eine neue Domain zu registrieren oder eine bestehende zu übertragen. Für das Hinzufügen einer neuen Domain sind erforderlich: 'domain', 'registrant', 'admin', 'tech', 'dns'; für die Übertragung einer bestehenden Domain sind erforderlich: 'domain', 'authinfo'

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

Domänenname

authinfo
required
string

Domain-Autorisierungscode

registrant
required
string

Kennung des Registranten

admin
required
string

Admin-Kennung

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

Mit dieser Methode können Sie die einzelne Domäne sehen, die sich auf den im Pfad übergebenen Parameter bezieht

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

Domänenname

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
}

Eine Domäne aktualisieren

Mit dieser Methode können Sie Domäneninformationen wie registrant, admin, tech oder dns aktualisieren. Sowohl "registrant" als auch "dns" müssen allein aktualisiert werden und nicht in Verbindung mit anderen Parametern, auch nicht zusammen

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

Identifizierung des neuen Registranten

admin
string

Identifizierung des neuen Administrators

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
}

Eine Domäne löschen

Mit dieser Methode können Sie eine Domäne löschen

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
}

Den Registranten holen

Diese Methode zeigt Ihnen, wer der Kontakt des Registranten Ihrer Domain ist

Authorizations:
bearerAuth
path Parameters
domain
required
string
Example: altravia.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

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Holen Sie sich den Admin

Diese Methode zeigt Ihnen, wer der Admin-Kontakt Ihrer Domain ist

Authorizations:
bearerAuth
path Parameters
domain
required
string
Example: altravia.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

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Holen Sie sich die Technik

Diese Methode zeigt Ihnen, wer der technische Kontakt für Ihre Domain ist

Authorizations:
bearerAuth
path Parameters
domain
required
string
Example: altravia.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

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Löschen Sie die Technik

Mit dieser Methode können Sie einen Tech aus einer bestimmten Domäne löschen

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

Domain-Name

handle
required
string
Example: AV-1463493248976

Technischer 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, "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