Documentation API L’hébergement web accessible à tous Visiter LWS

Obtenir toutes les extensions disponibles

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

operationIdgetDomainTlds

Récupère la liste de toutes les extensions (TLD) disponibles, leurs informations tarifaires et autres paramètres. Contient toutes les extensions pouvant être achetées via nos services.

Réponses

200

Liste des extensions récupérée sous forme de tableau associatif.

{
  "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"
    }
  ]
}
Champs de la réponse 14 Étend ApiEnvelope
  • code integer

    Code de statut/erreur applicatif (pas toujours égal au code de statut HTTP)

    Exemple: 200

  • info string

    Message lisible décrivant le résultat de la requête

    Exemple: All TLDs fetched

  • data object[]
  • tld string

    Extension de domaine (TLD)

    Exemple: .fr

  • transfer_possible string

    Indique si l'extension peut être transférée vers un autre registrar. 'oui' signifie que le transfert est possible, 'non' signifie que le transfert est interdit.

    Exemple: oui

  • local_country string

    Indique si l'extension est réservée à un pays spécifique. 'oui' signifie que l'extension est réservée à un pays spécifique, 'non' signifie qu'elle ne l'est pas.

    Exemple: oui

  • restore_possible string

    Indique si l'extension peut être restaurée après expiration. 'oui' signifie que la restauration est possible, 'non' signifie que la restauration est interdite.

    Exemple: oui

  • price_purchase string

    Prix d'achat de l'extension

    Exemple: 6.99

  • price_purchase_offer string

    Prix d'achat de l'extension avec une offre

    Exemple: 6.99

  • price_renew string

    Prix de renouvellement de l'extension

    Exemple: 8.99

  • price_restore string

    Prix de restauration de l'extension après expiration

    Exemple: 19.99

  • price_transfer string

    Prix de transfert de l'extension vers un autre registrar

    Exemple: 4.99

  • length string

    Longueur du nom de l'extension. Varie selon chaque extension mais a un maximum de 63 caractères

    Exemple: 3-63

  • minimum_period string

    Durée minimale d'achat de l'extension (en années)

    Exemple: 1

404

Extensions introuvables

{
  "code": 404,
  "info": "No TLDs found"
}
Champs de la réponse 2 Étend ApiEnvelope
  • code integer

    Code de statut/erreur applicatif (pas toujours égal au code de statut HTTP)

    Exemple: 404

  • info string

    Message lisible décrivant le résultat de la requête

    Exemple: No TLDs found

500

Erreur interne du serveur

{
  "code": 500,
  "info": "Internal Server Error",
  "data": "string"
}
Champs de la réponse 3 Étend ApiEnvelope
  • code integer

    Code de statut/erreur applicatif (pas toujours égal au code de statut HTTP)

    Exemple: 500

  • info string

    Message lisible décrivant le résultat de la requête

    Exemple: Internal Server Error

  • data string

    Message détaillé sur l'erreur

502

Passerelle incorrecte

{
  "code": 502,
  "info": "Invalid response from upstream server",
  "data": []
}
Champs de la réponse 3 Étend ApiEnvelope
  • code integer

    Code de statut/erreur applicatif (pas toujours égal au code de statut HTTP)

    Exemple: 502

  • info string

    Message lisible décrivant le résultat de la requête

    Exemple: Invalid response from upstream server

  • data object

    Réponse invalide retournée par le serveur

401

Non autorisé - En-têtes d'authentification manquants

{
  "code": 401,
  "info": "Unauthorized access to the API. Please specify X-Auth-Pass and X-Auth-Login to proceed."
}
Champs de la réponse 2
  • code integer

    Exemple: 401

  • info string

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

429

Limite de requêtes dépassée

{
  "code": 429,
  "info": "Rate limit exceeded. Please try again later."
}
Champs de la réponse 2
  • code integer

    Exemple: 429

  • info string

    Exemple: Rate limit exceeded. Please try again later.

Afficher les exemples de code et la console de test
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)