WAPI - WEDOS DNS - Documentación y base de conocimientos de WEDOS

Este artículo trata los comandos WAPI específicos del servicio WEDOS DNS. Para saber cómo configurar WAPI y resolver los problemas más habituales, consulte el artículo WAPI – Manual.

Este artículo ofrece información sobre las siguientes peticiones:

dns-domains-list – lista de dominios DNS de la cuenta del usuario
dns-domain-info – información sobre el dominio
dns-domain-add – añadir un dominio al DNS
dns-domain-update – actualizar un dominio en el DNS
dns-domain-delete – eliminar un dominio del DNS
dns-domain-axfr-run – solicitar una transferencia AXFR desde el servidor primario a nuestro DNS
dns-domain-axfr-tsig – actualizar o consultar la configuración de AXFR TSIG
dns-domain-copy – añadir un dominio al DNS copiando otro dominio
dns-domain-commit – guardar los cambios del DNS
dns-rows-list – obtener la lista de registros del dominio
dns-row-detail – obtener el detalle de un registro
dns-row-add – añadir un registro
dns-row-update – editar un registro
dns-row-delete – eliminar un registro

dns-domains-list

Utilice la petición dns-domains-list para obtener la lista de dominios DNS del usuario.

Parámetros

búsqueda – cadena que se busca entre los nombres de dominio – opcional
status – filtrar por estado (active, disabled) – opcional
type – filtrar por tipo de dominio (primary, secondary) – opcional
página – número de página (default: 1) – opcional
page_limit – número de elementos por página (default: 50) – opcional
orderby – ordenar los elementos por created_date o domain, seguido de asc/desc – opcional, véase la plantilla

Valores de retorno

1000 – OK

Datos de la respuesta

La petición devuelve la lista de dominios con esta plantilla:

dominio
- name – nombre del dominio
- status – estado del dominio en el sistema
- type – tipo (primary/secondary)

Plantillas

Petición JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-domains-list",
    "clTRID": "your ID",
    "data": { 
      "search": "search term in domain name",
      "status": "active|disabled",
      "type": "primary|secondary",
      "page": "page number",
      "page_limit": "number of entries per page",
      "orderby":"domain|created_date asc|desc"
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-domains-list",
    "data": {
      "domain": [
        {
          "name": "domain1 name in DNS",
          "type": "type (primary|secondary)",
          "status": "active|disabled"
        }
      ],
      "total": "número total de elementos",
      "page": "número de página",
      "page_limit": "número de elementos por página"
    }
  }
}

dns-domain-info

Utilice la petición dns-domain-info para obtener información básica sobre uno o varios dominios en el sistema WEDOS DNS (WDNS).

Parámetros

name – nombre del dominio; para varios dominios utilice una cadena separada por comas (véase la plantilla) – obligatorio

Valores de retorno

1000= OK
2201 = TLD no admitido
2202 = nombre de dominio no válido
3222 = no se pudo abrir el dominio
3223 = error de autorización
3305 = el dominio está bloqueado para su edición
3306 = el dominio está eliminado

Para varios dominios el valor de retorno es siempre 1000. Los posibles valores de error se muestran en los datos dominio , tal como se indica en la plantilla.

Datos de retorno

Si la operación se completa correctamente, la petición devuelve el detalle del dominio en WDNS en el nodo data/domain.

Plantillas

Petición JSON con 2 dominios:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-domain-info",
    "clTRID": "your ID",
    "data": {
      "name": "domain.name1, domain.name2"
    }
  }
}

Respuesta JSON (domain.name1 OK, domain.name2 error):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-domain-info",
    "data": {
      "domain": [{
        "name": "domain.name1",
        "status": "",
        "type": "",
        "tlock": "",
        "autocommit": "",
        "axfr_enabled": "outgoing axfr enabled? (0/1)",
        "axfr_ips": "allowed axfr IPs list",
        "changed": "",
        "changed_date": "",
        "commit_date": "",
        "reload_pending": "",
        "reload_pending_date": "",
        "reload_date": "",
        "disabled_date": "",
        "enabled_date": "",
        "add_date": "",
        "rname": "",
        "serial": "",
        "refresh": "",
        "retry": "",
        "expire": "",
        "minimum": "",
        "rr_cnt6": "",
        "ns_out": "",
        "ns1": ""
      },
      {
        "name": "domain.name2",
        "code": 3222,
        "result": "Domain open failed"
      }]
    }
  }
}

dns-domain-add

Utilice la petición dns-domain-add para añadir un nuevo dominio al DNS.

Parámetros

name – nombre del dominio, o varios nombres separados por comas (obligatorio)
type – tipo de registro del dominio (primary/secondary) – opcional (default: primary)
axfr_enabled – ¿está habilitada la transferencia axfr saliente? (0/1) – solo para dominios primary, opcional (default: 0)
axfr_ips – lista de direcciones ip autorizadas para axfr (solo para el registro primary; indique varias direcciones separadas por espacios; obligatorio si axfr_enabled=1)
primary_ip – direcciones ip del servidor dns primario (obligatorio si type=secondary)
primary_tsig_enabled – ¿está habilitado TSIG? (0/1) – solo para dominios secondary, opcional
primary_tsig_name – identificador TSIG – solo para dominios secondary, obligatorio si TSIG está habilitado
primary_tsig_alg – algoritmo TSIG – solo para dominios secondary, obligatorio si TSIG está habilitado
primary_tsig_key – clave TSIG – solo para dominios secondary, obligatorio si TSIG está habilitado
template_id – ID de un dominio de tipo plantilla – solo para dominios primary, opcional

Valores de retorno

1000 = correcto
2007 = tamaño máximo de la petición superado
2100 = falta un parámetro obligatorio
2101 = parámetros de entrada no válidos
2201 = TLD no admitido
2202 = nombre de dominio no válido
2301 = formato de type incorrecto
2302 = falta el parámetro primary_ip
2303 = formato incorrecto de primary_ip
2304 = formato no válido de axfr_enabled
2305 = falta el parámetro obligatorio axfr_ips
2306 = formato no válido de axfr_ips
2308 = formato no válido de ns
2322 = se ha alcanzado el límite de dominios en el DNS por usuario
2323 = plantilla no encontrada
2324 = no se puede crear un dominio primary mediante una plantilla
2325 = plantilla no definida
2330 = Solicitud no válida – dominio WDNS – TSIG primary – configuración no válida
2331 = Solicitud no válida – dominio WDNS – TSIG primary – formato de nombre no válido
2332 = Solicitud no válida – dominio WDNS – TSIG primary – formato de algoritmo no válido
2333 = Solicitud no válida – dominio WDNS – TSIG primary – formato de clave no válido
2340 = superado el número máximo de dominios por acción
3302 = no se pudo añadir el dominio al DNS
3303 = el dominio ya existe en el DNS

Datos de retorno

La petición no devuelve datos.

Plantillas

Petición JSON – dominio primary:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-domain-add",
    "clTRID": "your ID",
    "data": {
      "name": "domain1.tld, domain2.tld",
      "axfr_enabled": "0 or 1",
      "axfr_ips": "allowed AXFR address(es)",
      "template_id": "ID of domain records template"
    }
  }
}

Petición JSON – dominio secondary:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-domain-add",
    "clTRID": "your ID",
    "data": {
      "name": "domain1.tld, domain2.tld",
      "type": "secondary",
      "primary_ip": "primary IP address",
      "primary_tsig_enabled": "0 or 1",
      "primary_tsig_name": "tsig_identifier",
      "primary_tsig_alg": "hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512 or hmac-md5",
      "primary_tsig_key": "TSIG_key_value"
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-domain-add"
  }
}

Respuesta JSON para varios dominios:

{
  "response":{
    "code":1000,
    "result":"OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command":"dns-domain-add",
    "data": [
      {
        "code":1000,
        "result":"OK",
        "name":"domain1.tld",
        "domain_id":"service ID"
      },
      {
        "code":1000,
        "result":"OK",
        "name":"domain2.tld",
        "domain_id":"service ID"
      }
    ]
  }
}

dns-domain-update

Utilice la petición dns-domain-update para editar el dominio en el DNS.

Parámetros

name – nombre del dominio, o varios nombres separados por comas (obligatorio)
axfr_enabled – ¿está habilitada la transferencia axfr saliente? (0/1) – solo para dominios primary, opcional (default: 0)
axfr_ips – lista de direcciones ip autorizadas para axfr (solo para el registro primary, obligatorio si axfr_enabled=1)
ip – dirección ip para la transferencia axfr saliente
primary_ip – direcciones ip del servidor dns primario (obligatorio si type=secondary)
primary_tsig_enabled – ¿está habilitado TSIG? (0/1) – solo para dominios secondary, opcional
primary_tsig_name – identificador TSIG – solo para dominios secondary, obligatorio si TSIG está habilitado
primary_tsig_alg – algoritmo TSIG – solo para dominios secondary, obligatorio si TSIG está habilitado
primary_tsig_key – clave TSIG – solo para dominios secondary, obligatorio si TSIG está habilitado

Valores de retorno

1000 = correcto
2007 = tamaño máximo de la petición superado
2100 = falta un parámetro obligatorio
2101 = parámetros de entrada no válidos
2201 = TLD no admitido
2202 = nombre de dominio no válido
2302 = falta el parámetro primary_ip
2303 = formato incorrecto de primary_ip
2304 = formato no válido de axfr_enabled
2305 = falta el parámetro obligatorio axfr_ips
2306 = formato no válido de axfr_ips
2308 = formato no válido de ns
2322 = se ha alcanzado el límite de dominios en el DNS por usuario
2330 = Solicitud no válida – dominio WDNS – TSIG primary – configuración no válida
2331 = Solicitud no válida – dominio WDNS – TSIG primary – formato de nombre no válido
2332 = Solicitud no válida – dominio WDNS – TSIG primary – formato de algoritmo no válido
2333 = Solicitud no válida – dominio WDNS – TSIG primary – formato de clave no válido
2340 = superado el número máximo de dominios por acción
3302 = no se pudo añadir el dominio al DNS
3303 = el dominio ya existe en el DNS

Datos de retorno

La petición no devuelve datos.

Plantillas

Petición JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-domain-update",
    "clTRID": "your ID",
    "data": {
      "name": "domain1.tld, domain2.tld",
      "axfr_enabled": "0 or 1",
      "axfr_ips": "allowed AXFR IP address(es)",
      "primary_ip": "primary IP adderess",
      "primary_tsig_enabled": "0 or 1",
      "primary_tsig_name": "tsig_identifier",
      "primary_tsig_alg": "hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512 or hmac-md5",
      "primary_tsig_key": "TSIG_key_value"
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-domain-update"
  }
}

Respuesta JSON para varios dominios (OK):

{
  "response":{
    "code":1000,
    "result":"OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command":"dns-domain-update",
    "data": [
      {
        "code":1000,
        "result":"OK",
        "name":"domain1.tld",
      },
      {
        "code":1000,
        "result":"OK",
        "name":"domain2.tld",
      }
    ]
  }
}

dns-domain-delete

Utilice la petición dns-domain-delete para eliminar un dominio del DNS, incluidos todos sus registros.

Parámetros

name – nombre del dominio, o varios nombres separados por comas (obligatorio)

Valores de retorno

1000 = correcto
2007 = tamaño máximo de la petición superado
2340 = superado el número máximo de dominios por acción
3222 = no se pudo abrir el dominio
3223 = acceso denegado
3301 = no se puede eliminar el registro
3305 = el dominio está bloqueado para su edición
3306 = el dominio está eliminado

Datos de retorno

La petición no devuelve datos.

Plantillas

Petición JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-domain-delete",
    "clTRID": "your ID",
    "data": {
      "name": "domain1.tld, domain2.tld"
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",,
    "command": "dns-domain-delete"
  }
}

Respuesta JSON para varios dominios (OK):

{
  "response":{
    "code":1000,
    "result":"OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command":"dns-domain-delete",
    "data": [
      {
        "code":1000,
        "result":"OK",
        "name":"domain1.tld",
      },
      {
        "code":1000,
        "result":"OK",
        "name":"domain2.tld",
      }
    ]
  }
}

dns-domain-axfr-run

La petición dns-domain-axfr-run actualiza los registros DNS desde el servidor autoritativo primario mediante AXFR lo antes posible (en unos minutos). Se utiliza en los dominios secondary, en los que descargamos el contenido de la zona a nuestro sistema desde otro servidor.

Sin esta petición, AXFR utiliza los datos REFRESH y RETRY del registro SOA.

Parámetros

name – nombre del dominio – obligatorio

Valores de retorno

1000 = correcto
2201 = TLD no admitido
2202 = nombre de dominio no válido o no admitido
2319 = solo se puede realizar en dominios de tipo secondary
3222 = no se pudo abrir el dominio
3223 = acceso denegado
3305 = el dominio está bloqueado para su edición
3306 = el dominio está eliminado

Datos de retorno

next_run – momento en que se realizará la próxima actualización

Plantillas

Petición JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-domain-axfr-run",
    "clTRID": "your ID",
    "data": {
      "name": "domain name"
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-domain-axfr-run",
    "data": {
      "next_run": "date and time of next update"
    }
  }
}

dns-domain-axfr-tsig

La petición dns-domain-axfr-tsig se utiliza para crear/actualizar, eliminar o mostrar la información de la clave AXFR TSIG de uno o varios dominios.

TSIG (Transaction Signature) es un mecanismo de autenticación para las transferencias DNS (AXFR/IXFR) que verifica la identidad entre los servidores primario y secundario. Esta verificación será obligatoria en todas las transferencias a los servidores DNS secundarios y debe coincidir exactamente con su configuración.

Si el servidor primario no utiliza TSIG, no active esta opción: la transferencia AXFR fallará.

Parámetros

name – nombre del dominio, o varios nombres separados por comas (obligatorio)
axfr_tsig_action – acción AFXR TSIG – obligatorio
- crear – habilitar o actualizar AXFR TSIG
- cancel – deshabilitar AXFR TSIG
- info – mostrar la información de AXFR TSIG

Valores de retorno

1000 = correcto
2201 = TLD no admitido
2202 = nombre de dominio no válido o no admitido
2319 = solo se puede realizar en dominios de tipo secondary
2334 = AXFR TSIG no configurado
2335 = AXFR TSIG no creado
2336 = AXFR TSIG no deshabilitado
2337 = comando AXFR TSIG no válido
2340 = superado el número máximo de dominios por acción
3222 = no se pudo abrir el dominio
3223 = acceso denegado
3305 = el dominio está bloqueado para su edición
3306 = el dominio está eliminado

Datos de retorno

name = nombre del dominio
axfr_tsig_action – nombre de la acción AFXR TSIG
axfr_tsig_name – nombre de la clave AXFR TSIG
axfr_tsig_alg – algoritmo de la clave AXFR TSIG
axfr_tsig_key – valor de la clave AXFR TSIG

Plantillas

Petición JSON:

{
  "request":{
    "user": "your@login.tld",
    "auth": "authentication string",
    "command":"dns-domain-axfr-tsig",
    "clTRID": "your ID",
    "data":{
      "name":"domain1.tld, domain2.tld",
      "axfr_tsig_action":"create, cancel, or info"
    }
  }
}

Respuesta JSON del comando create (varios estados de dominio):

{
  "response":{
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command":"dns-domain-axfr-tsig",
    "data": [
      {
        "name":"domain1.tld",
        "code":1000,
        "result":"OK",
        "axfr_tsig_action":"create",
        "axfr_tsig_name":"keyname",
        "axfr_tsig_alg":"hmac-sha256",
        "axfr_tsig_key":"lbOYAMGHc6eSo3R2h6rWrHcsp3iSBp/0D0S7kjRqxLI="
      },
      {
        "name":"domain-swapi-00003y.cz",
        "code":3222,
        "result":"Domain open failed",
        "axfr_tsig_action":"create"
      }
    ]
  }
}

dns-domain-copy

Utilice la petición dns-domain-copy para añadir un dominio al DNS copiando la configuración y los registros de otro dominio existente.

Parámetros

name – nombre del dominio original (el que desea copiar) – obligatorio
name_new – nombre del dominio que se va a crear – obligatorio

Valores de retorno

1000 = correcto
2201 = TLD no admitido
2202 = nombre del dominio existente no válido o no admitido
2320 = nombre del nuevo dominio no válido o no admitido
2321 = TLD no admitido en el nombre del nuevo dominio
2322 = se ha alcanzado el límite de dominios en el DNS por usuario
3222 = no se pudo abrir el dominio
3223 = acceso denegado
3305 = el dominio está bloqueado para su edición
3306 = el dominio está eliminado
3311 = la copia ha fallado
3312 = el nuevo dominio ya existe en el DNS

Datos de retorno

La petición no devuelve datos.

Plantillas

Petición JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-domain-copy",
    "clTRID": "your ID",
    "data": {
      "name": "original domain name",
      "name_new": "new domain name"
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-domain-copy"
  }
}

dns-domain-commit

Utilice la petición dns-domain-commit después de realizar cualquier cambio en el dominio o en sus registros DNS. Así confirma los cambios y solicita su distribución a los servidores DNS.

Si no ejecuta el comando dns-domain-commit , el sistema lo ejecutará automáticamente 5 minutos después del último cambio.

Parámetros

name – nombre del dominio – obligatorio

Valores de retorno

1000 = correcto
2201 = TLD no admitido
2202 = nombre de dominio no válido o no admitido
3222 = no se pudo abrir el dominio
3223 = acceso denegado
3305 = el dominio está bloqueado para su edición
3306 = el dominio está eliminado

Datos de retorno

La petición no devuelve datos.

Plantillas

Petición JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-domain-commit",
    "clTRID": "your ID",
    "data": {
      "name": "domain name"
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-domain-commit"
  }
}

dns-rows-list

Utilice la petición dns-rows-list para obtener la lista de registros del dominio en el DNS junto con su información básica.

Para obtener información más detallada sobre un registro concreto, utilice la petición dns-row-detail .

Parámetros

dominio – nombre del dominio – obligatorio

Valores de retorno

1000 = correcto
2201 = TLD no admitido
2202 = nombre de dominio no válido o no admitido
2318 = no se puede realizar en dominios de tipo secondary
3222 = no se pudo abrir el dominio
3223 = acceso denegado
3305 = el dominio está bloqueado para su edición
3306 = el dominio está eliminado

Datos de la respuesta

row – registro
- ID – ID del registro
- name – nombre del registro
- ttl – TTL del registro
- rdtype – tipo del registro
- rdata – datos del registro
- changed_date – fecha de modificación
- author_comment – comentario

Plantillas

Petición JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-rows-list",
    "clTRID": "your ID",
    "data": {
      "domain": "domain name"
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-rows-list",
    "data": {
      "row1": {
        "ID": "record ID",
        "name": "record name (may be empty)",
        "ttl": "TTL",
        "rdtype": "record type",
        "rdata": "record data",
        "changed_date": "date and time of last update",
        "author_comment": "comment"
      }
    }
  }
}

dns-row-detail

La petición dns-row-detail devuelve información detallada sobre un registro DNS concreto del dominio.

Para obtener la lista completa de los registros de un dominio, utilice la petición dns-rows-list .

Parámetros

name – nombre del dominio – obligatorio
row_id – ID del registro – obligatorio, obtenido de dns-rows-list

Valores de retorno

1000 = correcto
2201 = TLD no admitido
2202 = nombre de dominio no válido o no admitido
2318 = Esta acción no se puede realizar en dominios de tipo secondary
3222 = no se pudo abrir el dominio
3223 = acceso denegado
3305 = el dominio está bloqueado para su edición
3306 = el dominio está eliminado
3309 = el registro DNS solicitado del dominio no existe

Datos de retorno

row – registro
- ID – ID del registro
- name – nombre del registro
- ttl – TTL del registro
- rdtype – tipo del registro
- rdata – datos del registro
- changed_date – fecha de modificación
- author_comment – comentario

Plantillas

Petición JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-row-detail",
    "clTRID": "your ID",
    "data": {
      "name": "nombre del dominio",
      "row_id": "ID del registro"
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-row-detail",
    "data": {
      "row1": {
        "ID": "record ID",
        "name": "record name (may be empty)",
        "ttl": "TTL",
        "rdtype": "record type",
        "rdata": "record data",
        "changed_date": "date and time of last update",
        "author_comment": "comment"
      }
    }
  }
}

dns-row-add

La petición dns-row-add añade un nuevo registro DNS al dominio.

De forma predeterminada, un dominio puede tener hasta 50 registros DNS. Si necesita más, contacte con el soporte &boxbox;. Indique en la solicitud el nombre del dominio, el número de registros deseado y una justificación detallada.

Parámetros

dominio – nombre del dominio – obligatorio
name – nombre del registro – obligatorio, pero puede estar vacío
ttl – valor TTL – obligatorio
type – tipo del registro – obligatorio
rdata – datos del registro – obligatorio
author_comment – comentario del autor – opcional. Si envía una cadena vacía, se borra el comentario anterior.

Valores de retorno

1000 = correcto
2100 = falta un parámetro obligatorio
2201 = TLD no admitido
2202 = nombre de dominio no válido o no admitido
2309 = tipo de registro no válido
2310 = no se puede añadir otro registro al dominio
2311 = nombre no válido
2312 = nombre no válido para ese tipo de registro
2313 = CNAME no válido para este nombre
2314 = datos del registro no válidos
2315 = TLD no válido
2316 = este registro ya existe
2317 = TTL no válido
2318 = la acción no se puede realizar en dominios de tipo secondary
3222 = no se pudo abrir el dominio
3223 = acceso denegado
3305 = el dominio está bloqueado para su edición
3306 = el dominio está eliminado
3307 = no se pudo añadir el registro del dominio
5001 = error interno de autenticación

Datos de retorno

La petición no devuelve datos.

Plantillas

Petición JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-row-add",
    "clTRID": "your ID",
    "data": {
      "domain": "domain name",
      "name": "record name (may be empty)",
      "ttl": "TTL",
      "type": "record type",
      "rdata": "record data"
    }
  }
}

Petición JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-row-add",
  }
}

dns-row-update

Utilice la petición dns-row-update para modificar un registro DNS.

No es posible cambiar el nombre ni el tipo de un registro. En ese caso, elimine el registro original y luego cree uno nuevo.

Parámetros

dominio – nombre del dominio – obligatorio
row_id – ID del registro – obligatorio, obtenido de dns-rows-list
ttl – valor TTL – obligatorio
rdata – datos del registro – obligatorio
author_comment – comentario del autor – opcional. Si envía una cadena vacía, se borra el comentario anterior.

Valores de retorno

1000 = correcto
2100 = falta un parámetro obligatorio
2201 = TLD no admitido
2202 = nombre de dominio no válido o no admitido
2309 = tipo de registro no válido
2310 = no se puede añadir otro registro al dominio
2311 = nombre no válido
2312 = nombre no válido para ese tipo de registro
2313 = CNAME no válido para este nombre
2314 = datos del registro no válidos
2315 = TLD no válido
2316 = este registro ya existe
2317 = TTL no válido
2318 = la acción no se puede realizar en dominios de tipo secondary
3222 = no se pudo abrir el dominio
3223 = acceso denegado
3305 = el dominio está bloqueado para su edición
3306 = el dominio está eliminado
3310 = no se pudo actualizar el registro del dominio
5001 = error interno de autenticación

Datos de retorno

La petición no devuelve datos.

Plantillas

Comando JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-row-update",
    "clTRID": "your ID",
    "data": {
      "domain": "domain name",
      "row_id": "row ID",
      "ttl": "TTL",
      "rdata": "record data"
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-row-update"
  }
}

dns-row-delete

Utilice la petición dns-row-delete para eliminar un registro DNS de un dominio.

Parámetros

dominio – nombre del dominio – obligatorio
row_id – ID del registro – obligatorio, obtenido de dns-rows-list

Valores de retorno

1000 = correcto
2201 = TLD no admitido
2202 = nombre de dominio no válido o no admitido
2318 = acción no válida para dominios de tipo secondary
3222 = no se pudo abrir el dominio
3223 = acceso denegado
3305 = el dominio está bloqueado para su edición
3306 = el dominio está eliminado
3308 = no se pudo eliminar el registro
3309 = no existe ningún registro con este ID

Datos de retorno

La petición no devuelve datos.

Plantillas

Petición JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-row-delete",
    "clTRID": "your ID",
    "data": {
      "domain": "domain name",
      "row_id": "record ID"
    }
  }
}

Petición JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-row-delete",
  }
}

¿Le ha resultado útil?

¡Gracias por su valoración!

WAPI – WEDOS DNS

dns-domains-list

Parámetros

Valores de retorno

Datos de la respuesta

Plantillas

dns-domain-info

Parámetros

Valores de retorno

Datos de retorno

Plantillas

dns-domain-add

Parámetros

Valores de retorno

Datos de retorno

Plantillas

dns-domain-update

Parámetros

Valores de retorno

Datos de retorno

Plantillas

dns-domain-delete

Parámetros

Valores de retorno

Datos de retorno

Plantillas

dns-domain-axfr-run

Parámetros

Valores de retorno

Datos de retorno

Plantillas

dns-domain-axfr-tsig

Parámetros

Valores de retorno

Datos de retorno

Plantillas

dns-domain-copy

Parámetros

Valores de retorno

Datos de retorno

Plantillas

dns-domain-commit

Parámetros

Valores de retorno

Datos de retorno

Plantillas

dns-rows-list

Parámetros

Valores de retorno

Datos de la respuesta

Plantillas

dns-row-detail

Parámetros

Valores de retorno

Datos de retorno

Plantillas

dns-row-add

Parámetros

Valores de retorno

Datos de retorno

Plantillas

dns-row-update

Parámetros

Valores de retorno

Datos de retorno

Plantillas

dns-row-delete

Parámetros

Valores de retorno

Datos de retorno

Plantillas

¿Le ha resultado útil?

Índice del artículo

Explorar categorías