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

Eliminar un registro de la zona DNS

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

operationIddeleteDomainZdns

Elimina un registro DNS específico de la zona DNS del dominio

Parámetros de ruta

domain string obligatorio

Nombre de dominio para el que eliminar el registro DNS

Cuerpo de la solicitud

  • id integer

    ID del registro DNS a eliminar (puede obtenerse con GET /domain/{domain}/zdns)

    Ejemplo: 234851

    obligatorio
Ejemplo de solicitud
{
  "id": 234851
}

Respuestas

200

Registro DNS eliminado correctamente

{
  "code": 200,
  "info": "Success: Removed record in the DNS Zone",
  "data": 234851
}
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: Success: Removed record in the DNS Zone

  • data integer

    ID del registro eliminado

    Ejemplo: 234851

201

Registro DNS ya eliminado / no encontrado

{
  "code": 201,
  "info": "The record 234851 does not exist or has already been deleted",
  "data": 234851
}
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: 201

  • info string

    Mensaje legible que describe el resultado de la solicitud

    Ejemplo: The record 234851 does not exist or has already been deleted

  • data integer

    Ejemplo: 234851

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

Solicitud incorrecta - entrada no válida

{
  "code": 400,
  "info": "Invalid input: No ID provided. Example: 234851"
}
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: Invalid input: No ID provided. Example: 234851

404

Registro DNS no encontrado

{
  "code": 404,
  "info": "Could not remove record from the DNS Zone",
  "data": 234851
}
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: 404

  • info string

    Mensaje legible que describe el resultado de la solicitud

    Ejemplo: Could not remove record from the DNS Zone

  • data integer

    Ejemplo: 234851

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

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.

Mostrar los ejemplos de código y la consola de pruebas
DELETE /domain/{domain}/zdns
LWS_AUTH_LOGIN='…'LWS_AUTH_PASS='…'curl -X DELETE \  "https://api.lws.net/v1/domain/{domain}/zdns" \  -H "X-Auth-Login: $LWS_AUTH_LOGIN" \  -H "X-Auth-Pass: $LWS_AUTH_PASS" \  -H "Content-Type: application/json" \  -d '{"id":234851}'
$lwsAuthLogin = '…';$lwsAuthPass = '…';$ch = curl_init("https://api.lws.net/v1/domain/{domain}/zdns");curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");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, '{"id":234851}');$res = json_decode(curl_exec($ch), true);
import requestsLWS_AUTH_LOGIN = "…"LWS_AUTH_PASS = "…"res = requests.delete(    "https://api.lws.net/v1/domain/{domain}/zdns",    headers={        "X-Auth-Login": LWS_AUTH_LOGIN,        "X-Auth-Pass": LWS_AUTH_PASS,    },    json={"id": 234851},)print(res.json())
const LWS_AUTH_LOGIN = "…";const LWS_AUTH_PASS = "…";const res = await fetch("https://api.lws.net/v1/domain/{domain}/zdns", {  method: "DELETE",  headers: {    "X-Auth-Login": LWS_AUTH_LOGIN,    "X-Auth-Pass": LWS_AUTH_PASS,    "Content-Type": "application/json",  },  body: JSON.stringify({"id":234851}),});const data = await res.json();
lwsAuthLogin := "…"lwsAuthPass := "…"body := strings.NewReader(`{"id":234851}`)req, _ := http.NewRequest("DELETE",    "https://api.lws.net/v1/domain/{domain}/zdns", 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)