Inhaltsverzeichnis dieser Seite

Funktion

Bei dem Auftrageestypen DomainUpdatePlus  kannst du im Gegensatz zum DomainUpdate die Daten eines Domain-Kontaktes (Handle) angeben, um diesen automatisch erstellen zu lassen. Falls schon ein Kontakt mit diesen Datn existiert, wird kein neuer angelegt, sondern der vorhandene verwendet. Innerhalb des "Domain"-Elements sind alle Schlüsselwörter möglich, die du auch beim DomainUpdate verwenden kannst. In den jeweiligen Domain-Kontakt-Elementen (ownerc, adminc, techc, zonec) kannst du alle Schlüsselwörter verwenden, die auch beim Bearbeiten eines Domain-Kontaktes gültig sind.

Wenn du bestimmte Schlüsselwörter nicht angibst, werden diese aus der Datenbank geladen.

Wird ein Inhaberwechsel ans System geschickt, wird eine vorhandene AuthInfo1 gelöscht. Liegt im System ein Kündigungsauftrag vom Typ Preack vor, dann wird automatisch eine neue AuthInfo1 erzeugt.

Die Beschreibung der Schlüsselwörter für Domain findest du  auf der Seite  Objekt Domain.Die Beschreibung der Schlüsselwörter für Domain-Kontakt (ownerc, adminc, techc, zonec)findest du auf der Seite Objekt Contact. Die Beschreibung der Schlüsselwörter für DNSSec findest du auf der Seite Objekt DNSSEC.

Beschreibung

Route: PUT /domain/{name}

Request
{
    "name": "example.com",
    "ownerc": {
    "address": [
        "Beispielstrasse 25"
    ],
    "fname": "Hans",
    "lname": "Mustermann",
    "pcode": "93055",
    "city": "Regensburg",
    "state": "Bayern",
    "country": "DE",
    "type": "PERSON",
    "email": "user@example.com",
    "phone": "+49-500-5000",
    "fax": "+49-500-6000"
    

    },
    "adminc": {
        "id": 21642636
    },
    "techc": {
        "id": 21642636
    },
    "nameServers": [
        {
          "name": "ns1.nameserver.com"
        },
        {
          "name": "ns2.nameserver.com"
        }
    ],
     "confirmOwnerConsent": "true"
}
Response
{
    "stid": "20201214-app2-dev-21464",
    "messages": [
        {
            "text": "DNS-Pruefung erfolgreich abgeschlossen.",
            "objects": [
                {
                    "type": "zone",
                    "value": "example.com"
                }
            ],
            "code": "S0206",
            "status": "SUCCESS"
        },
        {
            "text": "Domain-Kontakt wurde erfolgreich angelegt.",
            "objects": [
                {
                    "type": "handle",
                    "value": "23278842"
                }
            ],
            "code": "S0301",
            "status": "SUCCESS"
        }
    ],
    "status": {
        "code": "N0102",
        "text": "Die Aktualisierung der Domain wurde erfolgreich gestartet.",
        "type": "NOTIFY"
    },
    "object": {
        "type": "Domain",
        "value": "example.com"
    },
    "data": [
        {
            "created": "2020-12-14T13:56:12.467+0100",
            "updated": "2020-12-14T13:56:12.000+0100",
            "owner": {
                "context": 4,
                "user": "exampleuser"
            },
            "updater": {
                "context": 4,
                "user": "exampleuser"
            },
            "status": "RUNNING",
            "execution": "2020-12-14T13:56:11.000+0100",
            "id": 4299135813
        }
    ]
}

Auftragstyp-Code: 0102
Verwendet Objekt Domain

Einzelauftrag

Request
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0102</code>
		<domain>
			<name>example.com</name>
			<ownerc>
			<alias></alias>
			<type>PERSON</type>
			<fname>Max</fname>
			<lname>Mustermann</lname>
			<title></title>
			<organization>InterNetX</organization>
			<address>Beispielstrasse 20</address>
			<pcode>93047</pcode>
			<city>Regensburg</city>
			<state></state>
			<country>de</country>
			<phone>+49-123-123</phone>
			<fax>+49-123-123</fax>
			<email>user@example.com</email>
			<sip></sip>
			<protection>B</protection>
			<nic_ref>de</nic_ref>
			<nic_ref>com</nic_ref>
			<nic_ref>net</nic_ref>
			<nic_ref>eu</nic_ref>
			<remarks>Comment</remarks>
			<extension>
				<uk_type></uk_type>
				<uk_trade_name></uk_trade_name>
				<uk_company_no></uk_company_no>
			</extension>
		</ownerc>
			<adminc>9925345</adminc>
			<techc>9925346</techc>
			<zonec>9925346</zonec>
			<nserver>
				<name>ns1.example.com</name>
			</nserver>
			<nserver>
				<name>ns2.example.com</name>
				<ip>172.16.100.1</ip>
				<ip6>2001:0DB8::1</ip6>
			</nserver>
			<use_privacy>1</use_privacy>
			<confirm_owner_consent>1</confirm_owner_consent>
			<dnssec>
				<flags>257</flags>
				<protocol>3</protocol>
				<algorithm>5</algorithm>
				<publickey>key...</publickey>
			</dnssec>
		</domain>
		<reply_to>customer@example.com</reply_to>
	</task>
</request>
Response
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
	<result>
		<data>
			<domain_job>
				<job>
					<id>4395211756</id>
					<status>NOT_SET</status>
				</job>
			</domain_job>
		</data>
		<status>
			<code>N0102</code>
			<text>Die Aktualisierung der Domain wurde erfolgreich gestartet.</text>
			<type>notify</type>
			<object>
				<type>domain</type>
				<value>example.com</value>
			</object>
		</status>
	</result>
	<stid>20201214-app2-19346</stid>
</response>

Massenauftrag

Request
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0102</code>
		<ctid></ctid>
		<default>
			<ownerc>9925345</ownerc>
			<adminc>9925345</adminc>
			<techc>9925345</techc>
			<zonec>9925345</zonec>
			<nserver>
				<name>ns1.example.org</name>
				<ip>172.16.100.1</ip>
			</nserver>
			<nserver>
				<name>ns2.example.org</name>
				<ip>172.16.100.2</ip>
			</nserver>
			<dns_checks>soa</dns_checks>
			<confirm_owner_consent>1</confirm_owner_consent>
		</default>
		<domain>
			<name>example.org</name>
		</domain>
		<domain>
			<name>example.net</name>
		</domain>
		<domain>
			<name>example.biz</name>
		</domain>
		<reply_to>customer@example.com</reply_to>
	</task>
</request>
Response
<response>
	<result>
		<msg>
			<text>Die Aktualisierung der Domain wurde erfolgreich gestartet.</text>
			<code>N0102</code>
			<type>notify</type>
			<object>
				<type>domain</type>
				<value>example.org</value>
			</object>
		</msg>
		<msg>
			<text>Die Aktualisierung der Domain wurde erfolgreich gestartet.</text>
			<code>N0102</code>
			<type>notify</type>
			<object>
				<type>domain</type>
				<value>example.net</value>
			</object>
		</msg>
		<msg>
			<text>Die Aktualisierung der Domain wurde erfolgreich gestartet.</text>
			<code>N0102</code>
			<type>notify</type>
			<object>
				<type>domain</type>
				<value>example.biz</value>
			</object>
		</msg>
		<status>
			<code>N0102001</code>
			<text>Die Aktualisierung der Domains wurde erfolgreich gestartet.</text>
			<type>notify</type>
		</status>
	</result>
	<ctid/>
	<stid>20180213-app3-10304</stid>
</response>

Mögliche Fehlermeldungen

  • EF01020 - Domain ist bisher nicht registriert.
  • EF01021 - Domain ist bereits registriert.
  • EF01022 - Ungueltige Domain.
  • EF01023 - Ende der Registrierungs-Laufzeit konnte nicht ermittelt werden.
  • EF01024 - Die Antwort auf den Domain-Transfer-Antrag ist ungueltig.
  • EF01025 - Dieser Domain-Kontakt enthaelt keine Faxnummer und kann deshalb nicht als TechC oder ZoneC verwendet werden.
  • EF01026 - Dieser Auftragstyp ist fuer diese TLD nicht moeglich (Nur fuer .com/ .net /.org).
  • EF01027 - Fuer diesen Domain-Kontakt sind keine Whois-Daten verfuegbar.
  • EF01028 - Der Domain-Kontakt fehlt oder der Typ kann nicht als AdminC verwendet werden.
  • EF01029 - Fuer diesen Domain-Kontakt kann die erforderliche TLD-Referenz nicht automatisiert erstellt werden.
  • EF010200 - Dieser Personenname ist nicht gueltig. Er muss aus mindestens zwei und hoechstens fuenf Woertern bestehen. Mindestens zwei Woerter muessen mindestens zwei Buchstaben lang sein
  • EF010201 - Domain-Name ist laenger als die 63 erlaubten Zeichen.
  • EF010202 - Dieser Personenname ist nicht gueltig. Es sind nur die Zeichen A-Z, a-z und die Sonderzeichen "." und "-" erlaubt.
  • EF010203 - Es fehlen Erweiterungen für den .HK Domain-Kontakt.
  • EF010204 - Alle Domain-Kontakte für .HK müssen den gleichen Domain-Kontakt-Typ (PERSON oder ORG) haben.
  • EF010210 - Premium Domain-Name. Bitte wende dich an unseren Support.
  • EF010211 - Der Nameserver konnte bei der Registry nicht angemeldet werden, da die Nameserver-Domain nicht von uns verwaltet wird.
  • EF010212 - Die Preisklasse dieser Premium Domain entspricht nicht der der Registry.
  • EF010213 - Die Domain ist eine Premium Domain.