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 Keywords möglich, die du auch beim DomainUpdate verwenden kannst. In den jeweiligen Domain-Kontakt-Elementen (ownerc, adminc, techc, zonec) kannst du alle Keywords verwenden, die auch beim Bearbeiten eines Domain-Kontaktes gültig sind.

Wenn du bestimmte Keywords 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 Keywords für Domain findest du  auf der Seite  Objekt Domain.Die Beschreibung der Keywords für Domain-Kontakt (ownerc, adminc, techc, zonec)findest du auf der Seite Objekt Contact. Die Beschreibung der Keywords 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 
<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>