Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
titleColor#FFFFFF
titleBGColor#E44313
titleInhaltsverzeichnis dieser Seite

Table of Contents
outlinetrue
stylenone

Funktion

Der Auftragstyp DomainInfo zeigt die Daten einer Domain an, wenn die Domain registriert und im Bestand und Zugriff des Benutzers ist.

Note

Für die Abfrage der Domaindaten gibt es den zusätzlichen Parameter full_contact (XML) bzw. fullContact (JSON), mit dem die Daten aller Domain-Kontakte angezeigt werden können.

Beschreibung

SP Tabs group
dispositionhorizontal
SP Tab pane
anchor2286824
nameJSON

Route: GET /domain​domain/{name}

Es muss kein Body mitgeschickt werden.

Query-Parameter 

Über folgende Query-Parameter können weitere Daten ermittelt werden:

  • expire
  • domainCreated
  • ownerc
  • adminc
  • techc
  • zonec
Code Block
titleRequest
linenumberstrue
collapsetrue
{
}
Code Block
titleResponse
linenumberstrue
collapsetrue
{
    "stid": "20190628-app2-dev-23822",
    "status": {
        "code": "S0105",
        "text": "Domain-Daten wurden erfolgreich ermittelt.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Domain",
        "value": "example.com"
    },
    "data": [
        {
            "created": "2019-06-28T15:12:51.000+0200",
            "updated": "2019-06-28T15:13:09.000+0200",
            "owner": {
                "context": 4,
                "user": "exampleuser"
            },
            "updater": {
                "context": 4,
                "user": "exampleuser"
            },
            "name": "example-domain-321.com",
            "domainCreated": "2019-06-28T15:12:51.000+0200",
            "registryStatus": "LOCK",
            "nameServers": [
                {
                    "name": "ns1.example-nameserver.com"
                },
                {
                    "name": "ns2.example-nameserver.com"
                }
            ],
            "period": {
                "unit": "YEAR",
                "period": 1
            },
            "trustee": false,
            "privacy": false,
            "authinfo": "5DnRg7+Facz9xXos",
            "domainsafe": false,
            "registrarStatus": "ACTIVE",
            "rddsOptIn": "NOT_SET",
            "ownerc": {
                "id": 23142212
            },
            "adminc": {
                "id": 23142212
            },
            "techc": {
                "id": 23142212
            },
            "payable": "2020-06-28T15:12:51.000+0200",
            "validCertificate": false,
            "autoRenewStatus": "TRUE"
        }
    ]
}

Beispiel für Verwendung der Parameter

Code Block
titleJSON
GET /domain​/{name}?fullContact[]=ownerc&fullContact[]=adminc&keys[]=domainCreated?keys[]=expire
SP Tab pane
anchor87031
nameXML

Auftragstyp-Code: 0105
Verwendet Objekt Domain

Die Daten folgender Keywords können mit dem Keyword <key> abgefragt werden:

  • expire (nur für bestimmte TLDs)
  • domain_created
Code Block
languagexml
titleRequest
linenumberstrue
collapsetrue
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0105</code>
		<domain>
			<name>example.com</name>
		</domain>
	</task>
</request>
Code Block
languagexml
titleResponse
linenumberstrue
collapsetrue
<response>
    <result>
        <data>
            <domain>
				<name>example.com</name>
                <domain_created>2017-02-28 23:59:59</domain_created>
				<payable>2018-02-28 23:59:59</payable>
				<ownerc>21653083</ownerc>
				<adminc>21653083</adminc>
				<techc>21653083</techc>
				<zonec>21653083</zonec>
				<registry_status>NONE</registry_status>
				<nserver>
					<name>ns1.example.com</name>
				</nserver>
				<nserver>
					<name>ns2.example.com</name>
				</nserver>
				<period>1</period>
				<status>SUCCESS</status>
				<use_trustee>false</use_trustee>
				<use_privacy>false</use_privacy>
				<domainsafe>false</domainsafe>
				<certificate>false</certificate>
				<autorenew>true</autorenew>
				<extension/>
				<comment>my comment</comment>
				<registrar_status>ACTIVE</registrar_status>
				<owner>
					<user>customer</user>
					<context>4</context>
				</owner>
				<updater>
					<user>customer</user>
					<context>4</context>
				</updater>
				<created>2016-12-23 11:01:39</created>
				<updated>2018-01-05 16:20:38</updated>
			</domain>
        </data>
        <status>
            <code>S0105</code>
            <text>Domaindaten wurden erfolgreich ermittelt.</text>
            <type>success</type>
            <object>
                <type>domain</type>
                <value>example.com</value>
            </object>
        </status>
    </result>
    <ctid>customer-transaction-id</ctid>
    <stid>20160204-app1-test-98130</stid>
</response>