Domaininformationen abrufen

GET https://api.lws.net/v1/domain/{domain}

operationIdgetDomain

Ruft detaillierte Informationen zur angegebenen Domain ab, wie Inhaber, Status, DNS-Zone und mehr.

Pfadparameter

domain string erforderlich: Domainname, dessen Informationen abgerufen werden sollen

max. 255 Zeichen Beispiel: example.fr

Antworten

200

Domaininformationen erfolgreich abgerufen

{
  "code": 200,
  "info": "Fetched domain",
  "data": {
    "domain": "example.com",
    "dns1": "ns1.lwsdns.com",
    "dns2": "ns2.lwsdns.com",
    "dns3": "ns3.lwsdns.com",
    "dns4": "ns4.lwsdns.com",
    "owner": "358240",
    "redemption": "0",
    "clientHold": "1",
    "clientTransferProhibited": "1",
    "serverHold": "0"
  }
}

Felder der Antwort 13 Erweitert ApiEnvelope

code integer

Statuscode/Fehlercode auf Anwendungsebene (nicht immer identisch mit dem HTTP-Statuscode)

Beispiel: 200
info string

Lesbare Nachricht, die das Ergebnis der Anfrage beschreibt

Beispiel: Fetched domain
data object

DomainGet
domain string

Domainname

Beispiel: example.com
dns1 string

Erster DNS-Server der Domain

Beispiel: ns1.lwsdns.com
dns2 string

Zweiter DNS-Server der Domain

Beispiel: ns2.lwsdns.com
dns3 string

Dritter DNS-Server der Domain

Beispiel: ns3.lwsdns.com
dns4 string

Vierter DNS-Server der Domain

Beispiel: ns4.lwsdns.com
owner string

ID des aktuellen Inhabers der Domain

Beispiel: 358240
redemption string

Rückholstatus der Domain. '1' bedeutet, dass sich die Domain in der Rückholfrist befindet (abgelaufen, aber verlängerbar), '0' bedeutet Normalstatus.

Beispiel: 0
clientHold string

Aktivierungsstatus der Domain. '1' bedeutet aktiv, '0' bedeutet inaktiv (typischerweise aufgrund von Ablauf).

Beispiel: 1
clientTransferProhibited string

Transfersperrstatus. '1' bedeutet, dass die Übertragung untersagt ist, '0' bedeutet, dass Übertragungen erlaubt sind.

Beispiel: 1
serverHold string

Gibt an, ob die Domain vom Registrar gesperrt ist (z. B. aus rechtlichen Gründen oder wegen nicht konformem DNS). '1' bedeutet gesperrt, '0' bedeutet aktiv.

Beispiel: 0

400

Ungültige Eingabe

{
  "code": 400,
  "info": "No domain provided"
}

Felder der Antwort 2 Erweitert ApiEnvelope

code integer

Statuscode/Fehlercode auf Anwendungsebene (nicht immer identisch mit dem HTTP-Statuscode)

Beispiel: 400
info string

Lesbare Nachricht, die das Ergebnis der Anfrage beschreibt

Beispiel: No domain provided

314

Domain im Konto nicht gefunden

314 ist kein registrierter HTTP-Statuscode. Er ist spezifisch für diese API.

{
  "code": 314,
  "info": "Provided domain has not been found on your account. You must own this domain to manage it."
}

Felder der Antwort 2 Erweitert ApiEnvelope

code integer

Statuscode/Fehlercode auf Anwendungsebene (nicht immer identisch mit dem HTTP-Statuscode)

Beispiel: 314
info string

Lesbare Nachricht, die das Ergebnis der Anfrage beschreibt

Beispiel: Provided domain has not been found on your account. You must own this domain to manage it.

500

Interner Serverfehler

{
  "code": 500,
  "info": "Internal Server Error",
  "data": "string"
}

Felder der Antwort 3 Erweitert ApiEnvelope

code integer

Statuscode/Fehlercode auf Anwendungsebene (nicht immer identisch mit dem HTTP-Statuscode)

Beispiel: 500
info string

Lesbare Nachricht, die das Ergebnis der Anfrage beschreibt

Beispiel: Internal Server Error
data string

Ausführliche Fehlermeldung

502

Ungültiges Gateway

{
  "code": 502,
  "info": "Invalid response from upstream server",
  "data": []
}

Felder der Antwort 3 Erweitert ApiEnvelope

code integer

Statuscode/Fehlercode auf Anwendungsebene (nicht immer identisch mit dem HTTP-Statuscode)

Beispiel: 502
info string

Lesbare Nachricht, die das Ergebnis der Anfrage beschreibt

Beispiel: Invalid response from upstream server
data object

Ungültige Antwort des Servers

401

Nicht autorisiert - Authentifizierungs-Header fehlen

{
  "code": 401,
  "info": "Unauthorized access to the API. Please specify X-Auth-Pass and X-Auth-Login to proceed."
}

Felder der Antwort 2

code integer

Beispiel: 401
info string

Beispiel: Unauthorized access to the API. Please specify X-Auth-Pass and X-Auth-Login to proceed.

429

Anfragelimit überschritten

{
  "code": 429,
  "info": "Rate limit exceeded. Please try again later."
}

Felder der Antwort 2

code integer

Beispiel: 429
info string

Beispiel: Rate limit exceeded. Please try again later.

1$lwsAuthLogin = '…';2$lwsAuthPass = '…';34$ch = curl_init("https://api.lws.net/v1/domain/example.fr");5curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");6curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);7curl_setopt($ch, CURLOPT_HTTPHEADER, [8 "X-Auth-Login: " . $lwsAuthLogin,9 "X-Auth-Pass: " . $lwsAuthPass,10]);1112$res = json_decode(curl_exec($ch), true);

1import requests23LWS_AUTH_LOGIN = "…"4LWS_AUTH_PASS = "…"56res = requests.get(7 "https://api.lws.net/v1/domain/example.fr",8 headers={9 "X-Auth-Login": LWS_AUTH_LOGIN,10 "X-Auth-Pass": LWS_AUTH_PASS,11 },12)13print(res.json())

1const LWS_AUTH_LOGIN = "…";2const LWS_AUTH_PASS = "…";34const res = await fetch("https://api.lws.net/v1/domain/example.fr", {5 method: "GET",6 headers: {7 "X-Auth-Login": LWS_AUTH_LOGIN,8 "X-Auth-Pass": LWS_AUTH_PASS,9 },10});11const data = await res.json();

1lwsAuthLogin := "…"2lwsAuthPass := "…"34req, _ := http.NewRequest("GET",5 "https://api.lws.net/v1/domain/example.fr", nil)6req.Header.Set("X-Auth-Login", lwsAuthLogin)7req.Header.Set("X-Auth-Pass", lwsAuthPass)89resp, err := http.DefaultClient.Do(req)

Domaininformationen abrufen

Pfadparameter

Antworten

Fehler melden

KI-Assistent