API: Domain

Die Domain-API ermöglicht es Ihnen, von externen Systemen die Domain-Verwaltung anzusprechen. So sind alle gängigen Aktionen möglich - teilweise sogar in Echtzeit bei der Registrierungsstelle.

Auflisten

Sie können die Domains Ihres Kontos mit dem API-Kommando domain/list auflisten. Hierbei kann optional ein Parameter "domain" per GET oder POST übergeben werden, der nach einer Domain oder einem Teil von einer Domain sucht bzw. filtert.

Das zurückgegebene data-Array enthält für jede Domain ein Array mit detaillierten Domain-Informationen.

Registrieren

Für das Registrieren einer neuen Domain ist das Kommando domain/register zuständig. Diese Aktion ist kostenpflichtig. Es erwartet folgende Parameter:

• domain - vollständige Domain

• owner_firstname - Vorname des Domaininhabers
• owner_lastname - Nachname des Domaininhabers
• owner_company - Firma des Domaininhabers (optional)
• owner_street - Anschrift des Domaininhabers
• owner_country - Land des Domaininhabers (als zweistelliger Ländercode, zum Beispiel DE)
• owner_postcode - Postleitzahl des Domaininhabers
• owner_city - Stadt des Domaininhabers
• owner_telephone - Telefonnummer des Domaininhabers
• owner_telefax - Faxnummer des Domaininhabers (optional)
• owner_email - E-Mailadresse des Domaininhabers

• ns1 - Nameserver #1
• ns2 - Nameserver #2
• ns3 - Nameserver #3 (optional)
• ns4 - Nameserver #4 (optional)
• ns5 - Nameserver #5 (optional)
• ip - IPv4-Adresse für DNS-Zone (nur erforderlich, wenn DNS-Server vom Anbieter verwendet sollen und ns1 sowie ns2 diesen entsprechen)

• async - Nur setzen (Wert: 1), wenn Aktion im Hintergrund asynchron ausgeführt werden soll (kürzere Antwortzeiten)

Die Parameter für den Owner-C müssen auch für den Admin-C (admin_*) gesetzt werden. Sofern Ihr Konto für die Verwendung von eigenen Tech-C und Zone-C Handles zugelassen ist, können Sie auch zone_* und tech_* setzen. Werden diese nicht gesetzt, werden die Werte vom Anbieter genommen.

Transferieren

Für das Transferieren einer bestehenden Domain ist das Kommando domain/transfer zuständig. Diese Aktion ist kostenpflichtig, sofern kein interner Transfer vorgenommen wird. Es erwartet folgende Parameter:

• domain - vollständige Domain

• owner_firstname - Vorname des Domaininhabers
• owner_lastname - Nachname des Domaininhabers
• owner_company - Firma des Domaininhabers (optional)
• owner_street - Anschrift des Domaininhabers
• owner_country - Land des Domaininhabers (als zweistelliger Ländercode, zum Beispiel DE)
• owner_postcode - Postleitzahl des Domaininhabers
• owner_city - Stadt des Domaininhabers
• owner_telephone - Telefonnummer des Domaininhabers
• owner_telefax - Faxnummer des Domaininhabers (optional)
• owner_email - E-Mailadresse des Domaininhabers

• ns1 - Nameserver #1
• ns2 - Nameserver #2
• ns3 - Nameserver #3 (optional)
• ns4 - Nameserver #4 (optional)
• ns5 - Nameserver #5 (optional)
• ip - IPv4-Adresse für DNS-Zone (nur erforderlich, wenn DNS-Server vom Anbieter verwendet sollen und ns1 sowie ns2 diesen entsprechen)

• password - Authcode für den Domain-Umzug

• async - Nur setzen (Wert: 1), wenn Aktion im Hintergrund asynchron ausgeführt werden soll (kürzere Antwortzeiten)

Die Parameter für den Owner-C müssen auch für den Admin-C (admin_*) gesetzt werden. Sofern Ihr Konto für die Verwendung von eigenen Tech-C und Zone-C Handles zugelassen ist, können Sie auch zone_* und tech_* setzen. Werden diese nicht gesetzt, werden die Werte vom Anbieter genommen.

Bearbeiten

Über das Kommando domain/modify lassen sich bereits bei uns bestehende Domains bearbeiten. Es erwartet folgende Parameter:

• domain - vollständige Domain

• owner_firstname - Vorname des Domaininhabers
• owner_lastname - Nachname des Domaininhabers
• owner_company - Firma des Domaininhabers (optional)
• owner_street - Anschrift des Domaininhabers
• owner_country - Land des Domaininhabers (als zweistelliger Ländercode, zum Beispiel DE)
• owner_postcode - Postleitzahl des Domaininhabers
• owner_city - Stadt des Domaininhabers
• owner_telephone - Telefonnummer des Domaininhabers
• owner_telefax - Faxnummer des Domaininhabers (optional)
• owner_email - E-Mailadresse des Domaininhabers

• ns1 - Nameserver #1
• ns2 - Nameserver #2
• ns3 - Nameserver #3 (optional)
• ns4 - Nameserver #4 (optional)
• ns5 - Nameserver #5 (optional)
• ip - IPv4-Adresse für DNS-Zone (nur erforderlich, wenn DNS-Server vom Anbieter verwendet sollen und ns1 sowie ns2 diesen entsprechen)

• transfer_lock - Gibt an, ob die Domain wegtransferiert werden kann (0 = ja, 1 = nein)
• auto_renew - Gibt an, ob die Domain automatisch verlängert wird (0 = nein, 1 = ja - setzt ausreichendes Guthaben zum Zeitpunkt der anstehenden Verlängerung voraus)

• async - Nur setzen (Wert: 1), wenn Aktion im Hintergrund asynchron ausgeführt werden soll (kürzere Antwortzeiten)

Die Parameter für den Owner-C müssen auch für den Admin-C (admin_*) gesetzt werden. Sofern Ihr Konto für die Verwendung von eigenen Tech-C und Zone-C Handles zugelassen ist, können Sie auch zone_* und tech_* setzen. Werden diese nicht gesetzt, werden die Werte vom Anbieter genommen.

Inhaberwechsel / Trade

Bei manchen Domain-Registrierungsstellen ist der Inhaberwechsel einer Domain kostenpflichtig. Mit dem Kommando domain/trade lassen sich die Domain-Daten dann ändern, nicht aber mit domain/modify. Diese Aktion ist kostenpflichtig. Erwartet werden folgende Parameter:

• domain - vollständige Domain

• owner_firstname - Vorname des Domaininhabers
• owner_lastname - Nachname des Domaininhabers
• owner_company - Firma des Domaininhabers (optional)
• owner_street - Anschrift des Domaininhabers
• owner_country - Land des Domaininhabers (als zweistelliger Ländercode, zum Beispiel DE)
• owner_postcode - Postleitzahl des Domaininhabers
• owner_city - Stadt des Domaininhabers
• owner_telephone - Telefonnummer des Domaininhabers
• owner_telefax - Faxnummer des Domaininhabers (optional)
• owner_email - E-Mailadresse des Domaininhabers

• async - Nur setzen (Wert: 1), wenn Aktion im Hintergrund asynchron ausgeführt werden soll (kürzere Antwortzeiten)

Die Parameter für den Owner-C müssen auch für den Admin-C (admin_*) gesetzt werden. Sofern Ihr Konto für die Verwendung von eigenen Tech-C und Zone-C Handles zugelassen ist, können Sie auch zone_* und tech_* setzen. Werden diese nicht gesetzt, werden die Werte vom Anbieter genommen.

Authcode anfordern

Die Aktion domain/password erwartet nur die Angabe des Parameters "domain" (vollständiger Domainname) und gibt im data-Array den Wert "code" zurück. Dies ist der Authcode Ihrer Domain.

Löschung / Rückgabe

Die Aktion domain/delete erwartet nur die Angabe der Parameter "domain" (vollständiger Domainname) und "type". Der "type"-Parameter beschreibt, ob die Domain gelöscht (type = 0) oder in den Transit (dekonnektiert: type = 2 / konnektiert: type = 1) gegeben werden soll. Bei einem Transit wird keine Haftung dafür übernommen, ob dieser wirklich wie gewünscht (de-)konnektiert vorgenommen werden kann. Diese Aktion ist nicht ohne Weiteres widerrufbar.