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 la zone DNS d'un domaine

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

operationIdgetDomainZdns

Récupère la zone DNS du domaine spécifié. Retourne tous les enregistrements DNS du domaine, tels que A, CNAME, MX, et plus encore.

Paramètres du chemin

domain string requis

Nom de domaine dont la zone DNS doit être récupérée

max. 255 caractères Exemple: example.fr

Réponses

200

Zone DNS récupérée avec succès

 
{
  "code": 200,
  "info": "Fetched DNS Zone",
  "data": [
    {
      "id": "568470",
      "type": "AAAA",
      "name": "@",
      "value": "2001:0db8:85a3:0000:0000:8a2e:0370:7334",
      "ttl": 86400
    }
  ]
}
Champs de la réponse 8 É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 DNS Zone

  • data object[]
  • id integer

    ID de l'enregistrement. Utilisé pour les fonctions spécifiques à l'enregistrement comme DELETE

    Exemple: 568470

  • type string

    Type de champ à ajouter à la zone DNS. Doit être A, AAAA, CNAME, ANAME, MX, NS, TXT, SRV, SPF ou CAA

    Exemple: AAAA

  • name string

    Nom du champ à ajouter à la zone DNS. Son contenu dépend du type d'enregistrement à ajouter. Par exemple, @ ou mail pour les enregistrements A, www pour les enregistrements CNAME, @ pour NS, etc...

    Exemple: @

  • value string

    Valeur du champ à ajouter à la zone DNS. Peut être une adresse IP, un nom de domaine, un DNS, ...

    Exemple: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

  • ttl integer

    Durée de vie (TTL) du champ à ajouter à la zone DNS. Doit être 86400, 43200, 21600, 7200, 3600, 1800 ou 900

    Exemple: 86400

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