- Start
- API-Referenz
- API-Dokumentation (XML/ JSON)
- Auftragstypen
- Domain-Auftragstypen
Domain Info
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
{
}{
"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
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>
<auth>
<user>customer</user>
<password>password</password>
<context>4</context>
</auth>
<task>
<code>0105</code>
<domain>
<name>example.com</name>
</domain>
</task>
</request><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>