REST Resource: domain

Ressource: RdapDomain

Domainobjekt, wie in Abschnitt 5.3 von RFC 7483 definiert. "variants", "publicIds", "network" fehlt in der Spezifikation.

JSON-Darstellung 
{
  "objectClassName": string,
  "handle": string,
  "ldhName": string,
  "unicodeName": string,
  "nameservers": [
    {
      object (RdapNameserver)
    }
  ],
  "secureDNS": {
    object (SecureDns)
  },
  "entities": [
    {
      object (RdapEntity)
    }
  ],
  "status": [
    string
  ],
  "remarks": [
    {
      object (Remark)
    }
  ],
  "links": [
    {
      object (Link)
    }
  ],
  "port43": string,
  "events": [
    {
      object (Event)
    }
  ],
  "jsonResponse": {
    object (HttpBody)
  },
  "rdapConformance": [
    string
  ],
  "notices": [
    {
      object (Notice)
    }
  ],
  "lang": string,
  "errorCode": number,
  "title": string,
  "description": [
    string
  ]
}
Felder
objectClassName

string

Sollte immer auf den String „domain“ festgelegt sein.

handle

string

Ein String, der eine eindeutige Registry-ID der Domainobjektinstanz darstellt.

ldhName

string

Ein String, der einen Domainnamen in LDH-Form beschreibt, wie in Abschnitt 3 von RFC 7483 beschrieben.

unicodeName

string

Ein String, der einen Domainnamen mit U-Labels enthält, wie in Abschnitt 3 von RFC 7483 beschrieben.

nameservers[]

object (RdapNameserver)

Ein Array von Nameserver-Objekten.

secureDNS

object (SecureDns)

Der Name dieses Feldes ist eine Behelfslösung, sodass er in ein JSON-Feld mit dem Namen „secureDNS“ formatiert wird.

entities[]

object (RdapEntity)

Kontaktentitäten dieser Domain.

status[]

string

Liste der auf die Entität angewendeten Status. Beispiel: „Update unzulässig“.

remarks[]

object (Remark)

Anmerkungen in Bezug auf die Domain.

port43

string

WHOIS-Server für diese Domain. Beispiel: „whois.google.com“.

events[]

object (Event)

Ereignisse, die diese Domain betreffen.

jsonResponse

object (HttpBody)

HTTP-Antwort mit dem Inhaltstyp „application/json+rdap“.

rdapConformance[]

string

RDAP-Konformitätsstufe. Sollte nur gefüllt werden, wenn die Domain ein Objekt der obersten Ebene einer Antwort ist.

notices[]

object (Notice)

Hinweise zur Domain. Sollte nur gefüllt werden, wenn die Domain ein Objekt der obersten Ebene einer Antwort ist.

lang

string

Fehlercode für Sprache. Felder für Fehlerantwortinformationen, die in Abschnitt 6 von RFC 7483 definiert sind.

errorCode

number

HTTP-Fehlercode. Beispiel: „501“.

title

string

Fehlertitel.

description[]

string

Fehlerbeschreibung.

RDAP-Nameserver

Nameserver-Objekt wie in Abschnitt 5.2 von RFC 7483 definiert. „handle“, „entities“, „status“, „remarks“, „links“, „port43“, „events“ aus der Spezifikation fehlen.

JSON-Darstellung 
{
  "objectClassName": string,
  "ldhName": string,
  "unicodeName": string,
  "ipAddresses": [
    {
      object (IpAddressObject)
    }
  ]
}
Felder
objectClassName

string

Sollte immer auf den String „nameserver“ festgelegt sein.

ldhName

string

Ein String, der eine eindeutige Registry-ID des Nameservers darstellt, wie in Abschnitt 3 von RFC 7483 beschrieben.

unicodeName

string

Ein String, der einen DNS-Unicode-Namen des Nameservers enthält, wie in Abschnitt 3 von RFC 7483 beschrieben.

ipAddresses[]

object (IpAddressObject)

IP-Adressen dieses Nameservers.

IP-Adressenobjekt

JSON-Darstellung 
{
  "v4": [
    string
  ],
  "v6": [
    string
  ]
}
Felder
v4[]

string

Ein String-Array, das IPv4-Adressen des Nameservers enthält.

v6[]

string

Ein String-Array, das IPv6-Adressen des Nameservers enthält.

SecureDns

DNS-Daten der Domain. „events“, „links“ der Spezifikation fehlen.

JSON-Darstellung 
{
  "zoneSigned": boolean,
  "delegationSigned": boolean,
  "maxSigLife": number,
  "dsData": [
    {
      object (DsData)
    }
  ],
  "keyData": [
    {
      object (KeyData)
    }
  ]
}
Felder
zoneSigned

boolean

„True“, wenn die Zone signiert wurde, andernfalls „False“.

delegationSigned

boolean

Der Wert "true" wird festgelegt, wenn im übergeordneten Element DS-Einträge vorhanden sind, andernfalls ist der Wert "false".

maxSigLife

number

Stellt die Lebensdauer der Signatur in Sekunden dar, die beim Erstellen des RRSIG-DS-Eintrags in der übergeordneten Zone verwendet wird.

dsData[]

object (DsData)

DNS-DS-Einträge gemäß RFC 4034.

keyData[]

object (KeyData)

DNSKEY-Einträge der Domain gemäß RFC 4034.

DSData

JSON-Darstellung 
{
  "keyTag": number,
  "algorithm": number,
  "digest": string,
  "digestType": number
}
Felder
keyTag

number

Das Schlüssel-Tag-Feld eines DNS-DS-Eintrags.

algorithm

number

Algorithmusfeld eines DNS-DS-Eintrags.

digest

string

Digest-Feld eines DNS-DS-Eintrags.

digestType

number

Digesttypfeld eines DNS-DS-Eintrags.

Schlüsseldaten

„events“, „links“ der Spezifikation fehlen.

JSON-Darstellung 
{
  "flags": number,
  "protocol": number,
  "publicKey": string,
  "algorithm": number
}
Felder
flags

number

Flag-Feldwert im DNSKEY-Eintrag gemäß RFC 4034.

protocol

number

Der Wert des Protokollfelds des DNSKEY-Eintrags gemäß RFC 4034.

publicKey

string

Öffentlicher Schlüssel im DNSKEY-Eintrag gemäß RFC 4034.

algorithm

number

Algorithmusfeld eines DNSKEY-Eintrags gemäß RFC 4034.

RDAPEntity

Entitätsobjekt, wie in Abschnitt 5.1 von RFC 7483 definiert. „asEventActor“, „networks“, „autnums“ fehlt in der Spezifikation.

JSON-Darstellung 
{
  "objectClassName": string,
  "handle": string,
  "vcardArray": [
    value
  ],
  "roles": [
    string
  ],
  "publicIds": [
    {
      object (PublicId)
    }
  ],
  "entities": [
    {
      object (RdapEntity)
    }
  ],
  "status": [
    string
  ],
  "remarks": [
    {
      object (Remark)
    }
  ],
  "links": [
    {
      object (Link)
    }
  ],
  "port43": string,
  "events": [
    {
      object (Event)
    }
  ]
}
Felder
objectClassName

string

Sollte immer auf den String „entity“ festgelegt sein.

handle

string

Ein String, der eine eindeutige Registrierungskennung der Entität darstellt.

vcardArray[]

value (Value format)

Eine jCard mit den Kontaktdaten der Entität

roles[]

string

Ein String-Array, das jeweils die Beziehung zwischen einem Objekt und dem nächstgelegenen beinhaltenden Objekt angibt.

publicIds[]

object (PublicId)

Öffentliche ID der Entität, falls vorhanden.

entities[]

object (RdapEntity)

Bei Entitäten können auch andere Entitäten in einem Array eingebettet sein. Damit lässt sich eine Organisation mit bestimmten Personen modellieren, die bestimmte Verantwortungsbereiche erfüllen.

Wir verwenden dies, um einen Missbrauchskontakt darzustellen: Entitäten mit der Rolle „Registrator“ innerhalb eines Domainobjekts sollten ein internes Entitätsobjekt mit der Rolle „Missbrauch“ und eine entsprechende vCard mit Telefon- und E-Mail-Adressen des Missbrauchskontakts haben.
status[]

string

Liste der auf die Entität angewendeten Status. Beispiel: „privat“.

remarks[]

object (Remark)

Anmerkungen in Bezug auf die Entität.

port43

string

WHOIS-Server für diese Domain. Beispiel: „whois.google.com“.

events[]

object (Event)

Ereignisse, die für diese Entität aufgetreten sind.

Öffentliche ID

Öffentliche IDs, die in Abschnitt 4.8 von RFC 7483 definiert sind.

JSON-Darstellung 
{
  "type": string,
  "identifier": string
}
Felder
type

string

ID-Typ Beispiel: „IANA-Registrator-ID“.

identifier

string

Text der ID. Beispiel: „1“.

Bemerkung

Beschreibung des in Abschnitt 4.3 von RFC 7483 definierten Objekts.

JSON-Darstellung 
{
  "type": string,
  "title": string,
  "description": [
    string
  ],
  "links": [
    {
      object (Link)
    }
  ]
}
Felder
type

string

Typwerte gemäß Abschnitt 10.2.1 von RFC 7483, die für ein einzelnes Objekt gelten: „Objekt abgeschnitten aufgrund von Autorisierung“, „Objekt abgeschnitten aufgrund übermäßiger Belastung“, „Objekt wurde aufgrund unerklärlicher Gründe gekürzt“, „Objekt wurde aufgrund der Autorisierung entfernt“.

title

string

Titel der Bemerkung.

description[]

string

Tatsächlicher Text der Bemerkung.

Veranstaltung

Ereignisobjekt, das in Abschnitt 4.5 von RFC 7483 definiert ist.

JSON-Darstellung 
{
  "eventAction": string,
  "eventDate": string,
  "eventActor": string,
  "links": [
    {
      object (Link)
    }
  ]
}
Felder
eventAction

string

Aktion, die bei diesem Ereignis stattgefunden hat. Beispiel: „Registrierung“.

eventDate

string (Timestamp format)

Zeitstempel des Ereignisses Beispiel: „1990-12-31T23:59:59Z“.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".
eventActor

string

Alias des Ereignis-Akteurs. Beispiel: „SOMEID-LUNARNIC“. Es gibt jedoch einen Ereignistyp, der nicht über eventActor verfügen muss. Informationen zu diesem Ereignistyp finden Sie in Abschnitt 5.1 von RFC 7483.

Methoden

get

 RDAP-Informationen für eine Domain anhand des Namens suchen