Inhaltsverzeichnis dieser Seite

Funktion

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

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

Route:​ GET /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
Request 
{
}
Response 
{
    "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

JSON
GET /domain​/{name}?fullContact[]=ownerc&fullContact[]=adminc&keys[]=domainCreated?keys[]=expire

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
Request 
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0105</code>
		<domain>
			<name>example.com</name>
		</domain>
	</task>
</request>
Response 
<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>