API-Dokumentation Webhosting für alle
DE

Sprache

Français English Deutsch Español Português
LWS besuchen
Domain- & E-Mail-API

Dokumentation

Domain- & E-Mail-API
Startseite der Dokumentationen

Alle verfügbaren TLDs abrufen

GET https://api.lws.net/v1/domain/0/tlds

operationIdgetDomainTlds

Ruft eine Liste aller verfügbaren TLDs, ihrer Preisinformationen und weiterer Parameter ab. Enthält alle TLDs, die über unsere Dienste erworben werden können.

Antworten

200

Liste der TLDs als assoziatives Array abgerufen.

 
{
  "code": 200,
  "info": "All TLDs fetched",
  "data": [
    {
      "tld": ".fr",
      "transfer_possible": "oui",
      "local_country": "oui",
      "restore_possible": "oui",
      "price_purchase": "6.99",
      "price_purchase_offer": "6.99",
      "price_renew": "8.99",
      "price_restore": "19.99",
      "price_transfer": "4.99",
      "length": "3-63",
      "minimum_period": "1"
    }
  ]
}
Felder der Antwort 14 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: All TLDs fetched

  • data object[]
  • tld string

    Top-Level-Domain

    Beispiel: .fr

  • transfer_possible string

    Gibt an, ob die TLD zu einem anderen Registrar übertragen werden kann. 'oui' bedeutet, dass eine Übertragung möglich ist, 'non' bedeutet, dass sie untersagt ist.

    Beispiel: oui

  • local_country string

    Gibt an, ob die TLD für ein bestimmtes Land reserviert ist. 'oui' bedeutet, dass die TLD für ein bestimmtes Land reserviert ist, 'non' bedeutet, dass sie es nicht ist.

    Beispiel: oui

  • restore_possible string

    Gibt an, ob die TLD nach Ablauf wiederhergestellt werden kann. 'oui' bedeutet, dass eine Wiederherstellung möglich ist, 'non' bedeutet, dass sie untersagt ist.

    Beispiel: oui

  • price_purchase string

    Preis für den Kauf der TLD

    Beispiel: 6.99

  • price_purchase_offer string

    Angebotspreis für den Kauf der TLD

    Beispiel: 6.99

  • price_renew string

    Preis für die Verlängerung der TLD

    Beispiel: 8.99

  • price_restore string

    Preis für die Wiederherstellung der TLD nach Ablauf

    Beispiel: 19.99

  • price_transfer string

    Preis für die Übertragung der TLD zu einem anderen Registrar

    Beispiel: 4.99

  • length string

    Länge des TLD-Namens. Variiert je nach TLD, beträgt jedoch maximal 63 Zeichen

    Beispiel: 3-63

  • minimum_period string

    Mindestlaufzeit für den Kauf der TLD (in Jahren)

    Beispiel: 1

404

TLDs nicht gefunden

 
{
  "code": 404,
  "info": "No TLDs found"
}
Felder der Antwort 2 Erweitert ApiEnvelope
  • code integer

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

    Beispiel: 404

  • info string

    Lesbare Nachricht, die das Ergebnis der Anfrage beschreibt

    Beispiel: No TLDs found

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.

GET /domain/0/tlds 
LWS_AUTH_LOGIN='…'LWS_AUTH_PASS='…'curl -X GET \  "https://api.lws.net/v1/domain/0/tlds" \  -H "X-Auth-Login: $LWS_AUTH_LOGIN" \  -H "X-Auth-Pass: $LWS_AUTH_PASS"
$lwsAuthLogin = '…';$lwsAuthPass = '…';$ch = curl_init("https://api.lws.net/v1/domain/0/tlds");curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_HTTPHEADER, [    "X-Auth-Login: " . $lwsAuthLogin,    "X-Auth-Pass: " . $lwsAuthPass,]);$res = json_decode(curl_exec($ch), true);
import requestsLWS_AUTH_LOGIN = "…"LWS_AUTH_PASS = "…"res = requests.get(    "https://api.lws.net/v1/domain/0/tlds",    headers={        "X-Auth-Login": LWS_AUTH_LOGIN,        "X-Auth-Pass": LWS_AUTH_PASS,    },)print(res.json())
const LWS_AUTH_LOGIN = "…";const LWS_AUTH_PASS = "…";const res = await fetch("https://api.lws.net/v1/domain/0/tlds", {  method: "GET",  headers: {    "X-Auth-Login": LWS_AUTH_LOGIN,    "X-Auth-Pass": LWS_AUTH_PASS,  },});const data = await res.json();
lwsAuthLogin := "…"lwsAuthPass := "…"req, _ := http.NewRequest("GET",    "https://api.lws.net/v1/domain/0/tlds", nil)req.Header.Set("X-Auth-Login", lwsAuthLogin)req.Header.Set("X-Auth-Pass", lwsAuthPass)resp, err := http.DefaultClient.Do(req)