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

Actualizar los servidores de nombres de un dominio

Diferido

PUT https://api.lws.net/v1/domain/{domain}/dns

operationIdputDomainDns

Actualiza los servidores de nombres (NS1-NS4) del dominio especificado. Los NS no válidos o duplicados no se tendrán en cuenta y deben añadirse los 4, incluso si son los mismos que antes.

Esta solicitud se procesa en segundo plano: responde de inmediato mientras el trabajo continúa. Sígala con los endpoints de tareas o solicitudes.

Parámetros de ruta

domain string obligatorio

Nombre de dominio cuyo DNS se desea modificar

Cuerpo de la solicitud

application/json
  • ns1 string

    Servidor de nombres primario

    Ejemplo: ns1.lwsdns.com

    obligatorio
  • ns2 string

    Servidor de nombres secundario

    Ejemplo: ns2.lwsdns.com

    obligatorio
  • ns3 string

    Servidor de nombres terciario

    Ejemplo: ns3.lwsdns.com

    obligatorio
  • ns4 string

    Servidor de nombres cuaternario

    Ejemplo: ns4.lwsdns.com

    obligatorio
Ejemplo de solicitud 
{
  "ns1": "ns1.lwsdns.com",
  "ns2": "ns2.lwsdns.com",
  "ns3": "ns3.lwsdns.com",
  "ns4": "ns4.lwsdns.com"
}

Respuestas

200

Solicitud de actualización de los servidores de nombres DNS pendiente

 
{
  "code": 200,
  "info": "Your request to change the DNS of the domain is currently pending. If no changes are made after a few minutes, please make sure the nameservers are valid.",
  "data": "pending"
}
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: 200

  • info string

    Mensaje legible que describe el resultado de la solicitud

    Ejemplo: Your request to change the DNS of the domain is currently pending. If no changes are made after a few minutes, please make sure the nameservers are valid.

  • data string

    Ejemplo: pending

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.

400

Entrada no válida

 
{
  "code": 400,
  "info": "At least 2 nameservers are required",
  "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: 400

  • info string

    Mensaje legible que describe el resultado de la solicitud

    Ejemplo: At least 2 nameservers are required

  • data string[]
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 de 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

503

Estado inesperado

 
{
  "code": 503,
  "info": "Unexpected status: {status}",
  "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: 503

  • info string

    Mensaje legible que describe el resultado de la solicitud

    Ejemplo: Unexpected status: {status}

  • data string[]
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.

PUT /domain/{domain}/dns 
LWS_AUTH_LOGIN='…'LWS_AUTH_PASS='…'curl -X PUT \  "https://api.lws.net/v1/domain/{domain}/dns" \  -H "X-Auth-Login: $LWS_AUTH_LOGIN" \  -H "X-Auth-Pass: $LWS_AUTH_PASS" \  -H "Content-Type: application/json" \  -d '{"ns1":"ns1.lwsdns.com","ns2":"ns2.lwsdns.com","ns3":"ns3.lwsdns.com","ns4":"ns4.lwsdns.com"}'
$lwsAuthLogin = '…';$lwsAuthPass = '…';$ch = curl_init("https://api.lws.net/v1/domain/{domain}/dns");curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_HTTPHEADER, [    "X-Auth-Login: " . $lwsAuthLogin,    "X-Auth-Pass: " . $lwsAuthPass,    "Content-Type: application/json",]);curl_setopt($ch, CURLOPT_POSTFIELDS, '{"ns1":"ns1.lwsdns.com","ns2":"ns2.lwsdns.com","ns3":"ns3.lwsdns.com","ns4":"ns4.lwsdns.com"}');$res = json_decode(curl_exec($ch), true);
import requestsLWS_AUTH_LOGIN = "…"LWS_AUTH_PASS = "…"res = requests.put(    "https://api.lws.net/v1/domain/{domain}/dns",    headers={        "X-Auth-Login": LWS_AUTH_LOGIN,        "X-Auth-Pass": LWS_AUTH_PASS,    },    json={"ns1": "ns1.lwsdns.com", "ns2": "ns2.lwsdns.com", "ns3": "ns3.lwsdns.com", "ns4": "ns4.lwsdns.com"},)print(res.json())
const LWS_AUTH_LOGIN = "…";const LWS_AUTH_PASS = "…";const res = await fetch("https://api.lws.net/v1/domain/{domain}/dns", {  method: "PUT",  headers: {    "X-Auth-Login": LWS_AUTH_LOGIN,    "X-Auth-Pass": LWS_AUTH_PASS,    "Content-Type": "application/json",  },  body: JSON.stringify({"ns1":"ns1.lwsdns.com","ns2":"ns2.lwsdns.com","ns3":"ns3.lwsdns.com","ns4":"ns4.lwsdns.com"}),});const data = await res.json();
lwsAuthLogin := "…"lwsAuthPass := "…"body := strings.NewReader(`{"ns1":"ns1.lwsdns.com","ns2":"ns2.lwsdns.com","ns3":"ns3.lwsdns.com","ns4":"ns4.lwsdns.com"}`)req, _ := http.NewRequest("PUT",    "https://api.lws.net/v1/domain/{domain}/dns", body)req.Header.Set("X-Auth-Login", lwsAuthLogin)req.Header.Set("X-Auth-Pass", lwsAuthPass)req.Header.Set("Content-Type", "application/json")resp, err := http.DefaultClient.Do(req)