Documentación de la API El alojamiento web accesible para todos
ES

Idioma

Français English Deutsch Español Português
Visitar LWS
API Dominios y Correo

Documentación

API Dominios y Correo
Inicio de la documentación

Obtener información de un dominio

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

operationIdgetDomain

Obtiene información detallada sobre el dominio especificado, como su propietario, estado, zona DNS, y más.

Parámetros de ruta

domain string obligatorio

Nombre de dominio cuya información se desea obtener

máx. 255 caracteres Ejemplo: example.fr

Respuestas

200

Información del dominio obtenida correctamente

 
{
  "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"
  }
}
Campos de la respuesta 13 Extiende ApiEnvelope
  • code integer

    Código de estado/error a nivel de aplicación (no siempre igual al código de estado HTTP)

    Ejemplo: 200

  • info string

    Mensaje legible que describe el resultado de la solicitud

    Ejemplo: Fetched domain

  • data object

    DomainGet

  • domain string

    Nombre de dominio

    Ejemplo: example.com

  • dns1 string

    Primer DNS del dominio

    Ejemplo: ns1.lwsdns.com

  • dns2 string

    Segundo DNS del dominio

    Ejemplo: ns2.lwsdns.com

  • dns3 string

    Tercer DNS del dominio

    Ejemplo: ns3.lwsdns.com

  • dns4 string

    Cuarto DNS del dominio

    Ejemplo: ns4.lwsdns.com

  • owner string

    ID del propietario actual del dominio

    Ejemplo: 358240

  • redemption string

    Estado de redención del dominio. '1' indica que el dominio está en periodo de redención (expirado pero renovable), '0' indica estado normal.

    Ejemplo: 0

  • clientHold string

    Estado de activación del dominio. '1' significa activo, '0' significa inactivo (normalmente debido a la expiración).

    Ejemplo: 1

  • clientTransferProhibited string

    Estado de bloqueo de transferencia. '1' indica que la transferencia está prohibida, '0' indica que las transferencias están permitidas.

    Ejemplo: 1

  • serverHold string

    Indica si el dominio está bloqueado por el registrador (por ejemplo, por motivos legales o un DNS no conforme). '1' significa bloqueado, '0' significa activo.

    Ejemplo: 0

400

Entrada no válida

 
{
  "code": 400,
  "info": "No domain provided"
}
Campos de la respuesta 2 Extiende ApiEnvelope
  • code integer

    Código de estado/error a nivel de aplicación (no siempre igual al código de estado HTTP)

    Ejemplo: 400

  • info string

    Mensaje legible que describe el resultado de la solicitud

    Ejemplo: No domain provided

314

Dominio no encontrado en la cuenta

314 no es un código de estado HTTP registrado. Es específico de esta API.

{
  "code": 314,
  "info": "Provided domain has not been found on your account. You must own this domain to manage it."
}
Campos de la respuesta 2 Extiende ApiEnvelope
  • code integer

    Código de estado/error a nivel de aplicación (no siempre igual al código de estado HTTP)

    Ejemplo: 314

  • info string

    Mensaje legible que describe el resultado de la solicitud

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

500

Error interno del servidor

 
{
  "code": 500,
  "info": "Internal Server Error",
  "data": "string"
}
Campos de la respuesta 3 Extiende ApiEnvelope
  • code integer

    Código de estado/error a nivel de aplicación (no siempre igual al código de estado HTTP)

    Ejemplo: 500

  • info string

    Mensaje legible que describe el resultado de la solicitud

    Ejemplo: Internal Server Error

  • data string

    Mensaje detallado sobre el error

502

Puerta de enlace incorrecta

 
{
  "code": 502,
  "info": "Invalid response from upstream server",
  "data": []
}
Campos de la respuesta 3 Extiende ApiEnvelope
  • code integer

    Código de estado/error a nivel de aplicación (no siempre igual al código de estado HTTP)

    Ejemplo: 502

  • info string

    Mensaje legible que describe el resultado de la solicitud

    Ejemplo: Invalid response from upstream server

  • data object

    Respuesta no válida devuelta por el servidor

401

No autorizado - Faltan las cabeceras de autenticación

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

    Ejemplo: 401

  • info string

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

429

Límite de solicitudes excedido

 
{
  "code": 429,
  "info": "Rate limit exceeded. Please try again later."
}
Campos de la respuesta 2
  • code integer

    Ejemplo: 429

  • info string

    Ejemplo: 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)