Documentation API L’hébergement web accessible à tous
FR

Langue

Français English Deutsch Español Português
Visiter LWS
API Noms de domaine & Emails

Documentation

API Noms de domaine & Emails
Page d’accueil des documentations

Obtenir les informations d'un domaine

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

operationIdgetDomain

Récupère des informations détaillées sur le domaine spécifié, telles que son propriétaire, son statut, sa zone DNS, et plus encore.

Paramètres du chemin

domain string requis

Nom de domaine dont les informations doivent être récupérées

max. 255 caractères Exemple: example.fr

Réponses

200

Informations sur le domaine récupérées avec succès

 
{
  "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"
  }
}
Champs de la réponse 13 É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: Fetched domain

  • data object

    DomainGet

  • domain string

    Nom de domaine

    Exemple: example.com

  • dns1 string

    Premier DNS du domaine

    Exemple: ns1.lwsdns.com

  • dns2 string

    Second DNS du domaine

    Exemple: ns2.lwsdns.com

  • dns3 string

    Troisième DNS du domaine

    Exemple: ns3.lwsdns.com

  • dns4 string

    Quatrième DNS du domaine

    Exemple: ns4.lwsdns.com

  • owner string

    ID du propriétaire actuel du domaine

    Exemple: 358240

  • redemption string

    Statut de rédemption du domaine. '1' indique que le domaine est en période de rédemption (expiré mais renouvelable), '0' indique un statut normal.

    Exemple: 0

  • clientHold string

    Statut d'activation du domaine. '1' signifie actif, '0' signifie inactif (généralement en raison d'une expiration).

    Exemple: 1

  • clientTransferProhibited string

    Statut de verrouillage du transfert. '1' indique que le transfert est interdit, '0' indique que les transferts sont autorisés.

    Exemple: 1

  • serverHold string

    Indique si le domaine est bloqué par le registrar (par exemple pour des raisons légales ou un DNS non conforme). '1' signifie bloqué, '0' signifie actif.

    Exemple: 0

400

Entrée invalide

 
{
  "code": 400,
  "info": "No domain provided"
}
Champs de la réponse 2 Étend ApiEnvelope
  • code integer

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

    Exemple: 400

  • info string

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

    Exemple: No domain provided

314

Domaine introuvable sur le compte

314 n’est pas un code de statut HTTP enregistré. Il est spécifique à cette API.

{
  "code": 314,
  "info": "Provided domain has not been found on your account. You must own this domain to manage it."
}
Champs de la réponse 2 Étend ApiEnvelope
  • code integer

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

    Exemple: 314

  • info string

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

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

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.

GET /domain/{domain} 
LWS_AUTH_LOGIN='…'LWS_AUTH_PASS='…'curl -X GET \  "https://api.lws.net/v1/domain/example.fr" \  -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/example.fr");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/example.fr",    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/example.fr", {  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/example.fr", nil)req.Header.Set("X-Auth-Login", lwsAuthLogin)req.Header.Set("X-Auth-Pass", lwsAuthPass)resp, err := http.DefaultClient.Do(req)