Este artículo trata sobre los comandos de WAPI específicos del servicio WEDOS DNS. Para saber cómo configurar WAPI y resolver problemas habituales, consulte el artículo WAPI – Manual.
Este artículo ofrece información sobre las siguientes solicitudes:
- 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 dominio al DNS
- dns-domain-update – actualizar el dominio en el DNS
- dns-domain-delete – eliminar dominio del DNS
- dns-domain-axfr-run – solicitar la transferencia AXFR desde el servidor primario a nuestro DNS
- dns-domain-axfr-tsig – actualizar o comprobar la configuración de AXFR TSIG
- dns-domain-copy – añadir un dominio al DNS copiando otro dominio
- dns-domain-commit – guardar los cambios de DNS
- dns-rows-list – obtener la lista de registros del dominio
- dns-row-detail – obtener el detalle del registro
- dns-row-add – añadir registro
- dns-row-update – editar registro
- dns-row-delete – eliminar registro
dns-domains-list
Utilice el dns-domains-list para listar los dominios DNS del usuario.
Parámetros
- search – 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 (predeterminado: 1) – opcional
- page_limit – número de entradas por página (predeterminado: 50) – opcional
- orderby – ordenar las entradas por created_date o domain, seguido de asc/desc – opcional, véase la plantilla
Valores de retorno
- 1000 – OK
Datos de la respuesta
La solicitud devuelve una lista de dominios que utilizan esta plantilla:
- dominio
- name – nombre de dominio
- status – estado del dominio en el sistema
- type – tipo (primary/secondary)
Plantillas
Solicitud 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": "počet položek celkem",
"page": "číslo stránky",
"page_limit": "počet položek na stránku"
}
}
}
dns-domain-info
Utilice el dns-domain-info para consultar información básica sobre uno o varios dominios en el sistema DNS de WEDOS (WDNS).
Parámetros
- name – nombre de dominio; para varios dominios use 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= error al abrir el dominio
- 3223= error de autorización
- 3305= el dominio está bloqueado para su edición
- 3306= el dominio está eliminado
El valor de retorno para varios dominios es siempre 1000. Los posibles valores de error se muestran en dominio datos, tal y como se muestra en la plantilla.
Datos de retorno
Si la operación se realiza correctamente, la solicitud devuelve el detalle del dominio en WDNS en el nodo data/domain.
Plantillas
Solicitud 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 el dns-domain-add para añadir un nuevo dominio al DNS.
Parámetros
- name – nombre de dominio, o varios nombres separados por comas (obligatorio)
- type – tipo de registro de dominio (primary/secondary) – opcional (predeterminado: primary)
- axfr_enabled – ¿está activado el axfr saliente? (0/1) – solo dominios primarios, opcional (predeterminado: 0)
- axfr_ips – lista de direcciones ip habilitadas para axfr (solo para la entrada primaria, introduzca varias direcciones como una lista separada por espacios; obligatorio si axfr_enabled=1)
- primary_ip – direcciones ip del servidor dns primario (obligatorio si type=secondary)
- primary_tsig_enabled – ¿está TSIG activado? (0/1) – solo dominios secundarios, opcional
- primary_tsig_name – identificador TSIG – solo dominios secundarios, obligatorio si TSIG está activado
- primary_tsig_alg – algoritmo TSIG – solo dominios secundarios, obligatorio si TSIG está activado
- primary_tsig_key – clave TSIG – solo dominios secundarios, obligatorio si TSIG está activado
- template_id – ID de un dominio de tipo plantilla – solo dominio primario, opcional
Valores de retorno
- 1000 = ok
- 2007 = tamaño máximo de solicitud 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 de axfr_enabled no válido
- 2305 = falta el parámetro obligatorio axfr_ips
- 2306 = formato de axfr_ips no válido
- 2308 = formato de ns no válido
- 2322 = límite de dominios en el DNS por usuario alcanzado
- 2323 = plantilla no encontrada
- 2324 = no se puede crear un dominio primario mediante una plantilla
- 2325 = plantilla no definida
- 2330 = Solicitud no válida – dominio WDNS – TSIG primario – configuración no válida
- 2331 = Solicitud no válida – dominio WDNS – TSIG primario – formato de nombre no válido
- 2332 = Solicitud no válida – dominio WDNS – TSIG primario – formato de algoritmo no válido
- 2333 = Solicitud no válida – dominio WDNS – TSIG primario – formato de clave no válido
- 2340 = número máximo de dominios por acción superado
- 3302 = error al añadir el dominio al DNS
- 3303 = el dominio ya existe en el DNS
Datos de retorno
La solicitud no devuelve datos.
Plantillas
Solicitud JSON – dominio primario:
{
"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"
}
}
}
Solicitud JSON – dominio secundario:
{
"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 el dns-domain-update para editar el dominio en el DNS.
Parámetros
- name – nombre de dominio, o varios nombres separados por comas (obligatorio)
- axfr_enabled – ¿está activado el axfr saliente? (0/1) – solo dominios primarios, opcional (predeterminado: 0)
- axfr_ips – lista de direcciones ip habilitadas para axfr (solo para la entrada primaria, obligatorio si axfr_enabled=1)
- ip – dirección ip para el axfr saliente
- primary_ip – direcciones ip del servidor dns primario (obligatorio si type=secondary)
- primary_tsig_enabled – ¿está TSIG activado? (0/1) – solo dominios secundarios, opcional
- primary_tsig_name – identificador TSIG – solo dominios secundarios, obligatorio si TSIG está activado
- primary_tsig_alg – algoritmo TSIG – solo dominios secundarios, obligatorio si TSIG está activado
- primary_tsig_key – clave TSIG – solo dominios secundarios, obligatorio si TSIG está activado
Valores de retorno
- 1000 = ok
- 2007= tamaño máximo de solicitud 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 de axfr_enabled no válido
- 2305 = falta el parámetro obligatorio axfr_ips
- 2306 = formato de axfr_ips no válido
- 2308 = formato de ns no válido
- 2322 = límite de dominios en el DNS por usuario alcanzado
- 2330 = Solicitud no válida – dominio WDNS – TSIG primario – configuración no válida
- 2331 = Solicitud no válida – dominio WDNS – TSIG primario – formato de nombre no válido
- 2332 = Solicitud no válida – dominio WDNS – TSIG primario – formato de algoritmo no válido
- 2333 = Solicitud no válida – dominio WDNS – TSIG primario – formato de clave no válido
- 2340= número máximo de dominios por acción superado
- 3302 = error al añadir el dominio al DNS
- 3303 = el dominio ya existe en el DNS
Datos de retorno
La solicitud no devuelve datos.
Plantillas
Solicitud 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 el dns-domain-delete para eliminar un dominio del DNS, incluidos todos sus registros.
Parámetros
- name – nombre de dominio, o varios nombres separados por comas (obligatorio)
Valores de retorno
- 1000 = ok
- 2007= tamaño máximo de solicitud superado
- 2340= número máximo de dominios por acción superado
- 3222= error al abrir el dominio
- 3223= acceso denegado
- 3301= el registro no se puede eliminar
- 3305= el dominio está bloqueado para su edición
- 3306= el dominio está eliminado
Datos de retorno
La solicitud no devuelve datos.
Plantillas
Solicitud 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
El dns-domain-axfr-run actualiza los registros DNS desde el servidor autoritativo primario mediante AXFR lo antes posible (en pocos minutos). Se usa para dominios secundarios, donde descargamos el contenido de la zona a nuestro sistema desde otro servidor.
Sin esta solicitud, AXFR utiliza los datos REFRESH y RETRY del registro SOA.
Parámetros
- name – nombre de dominio – obligatorio
Valores de retorno
- 1000 = ok
- 2201= TLD no admitido
- 2202= nombre de dominio no válido o no admitido
- 2319= solo se puede realizar en un dominio de tipo secundario
- 3222= error al 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 siguiente actualización
Plantillas
Solicitud 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
El dns-domain-axfr-tsig se usa 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 transferencias DNS (AXFR/IXFR) que proporciona verificación de identidad entre los servidores primario y secundario. Esta verificación será obligatoria para todas las transferencias a servidores DNS secundarios y debe coincidir exactamente con su configuración.
Si el servidor primario no utiliza TSIG, no active esta opción, ya que la transferencia AXFR fallará.
Parámetros
- name – nombre de dominio, o varios nombres separados por comas (obligatorio)
- axfr_tsig_action – acción AFXR TSIG – obligatorio
- crear – activar o actualizar AXFR TSIG
- cancelar – desactivar AXFR TSIG
- info – mostrar información de AXFR TSIG
Valores de retorno
- 1000 = ok
- 2201= TLD no admitido
- 2202= nombre de dominio no válido o no admitido
- 2319= solo se puede realizar en un dominio de tipo secundario
- 2334 = AXFR TSIG no configurado
- 2335 = AXFR TSIG no creado
- 2336 = AXFR TSIG no desactivado
- 2337 = comando AXFR TSIG no válido
- 2340 = número máximo de dominios por acción superado
- 3222= error al 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 de 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
Solicitud 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 el dns-domain-copy comando para añadir un dominio al DNS copiando la configuración y los registros de otro ya existente.
Parámetros
- name – nombre del dominio original (el que quiere copiar) – obligatorio
- name_new – nombre del dominio recién creado – obligatorio
Valores de retorno
- 1000 = ok
- 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 del nuevo nombre de dominio no admitido
- 2322= límite del número de dominios en el DNS por usuario alcanzado
- 3222= error al abrir el dominio
- 3223= acceso denegado
- 3305= el dominio está bloqueado para su edición
- 3306= el dominio está eliminado
- 3311= error al copiar
- 3312= el nuevo dominio ya existe en el DNS
Datos de retorno
La solicitud no devuelve datos.
Plantillas
Solicitud 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 el dns-domain-commit después de realizar cualquier cambio en el dominio o en sus registros DNS. Confirma los cambios y solicita su distribución a los servidores DNS.
Si no ejecuta el dns-domain-commit comando, el sistema lo ejecutará automáticamente 5 minutos después del último cambio.
Parámetros
- name – nombre de dominio – obligatorio
Valores de retorno
- 1000 = ok
- 2201= TLD no admitido
- 2202= nombre de dominio no válido o no admitido
- 3222= error al abrir el dominio
- 3223= acceso denegado
- 3305= el dominio está bloqueado para su edición
- 3306= el dominio está eliminado
Datos de retorno
La solicitud no devuelve datos.
Plantillas
Solicitud 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 el dns-rows-list para obtener una lista de los registros de dominio en el DNS junto con información básica.
Para obtener información más detallada sobre un registro concreto, utilice el dns-row-detail solicitud.
Parámetros
- dominio – nombre de dominio – obligatorio
Valores de retorno
- 1000 = ok
- 2201= TLD no admitido
- 2202= nombre de dominio no válido o no admitido
- 2318= no se puede realizar en un dominio de tipo secundario
- 3222= error al 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 de registro
- rdata – datos del registro
- changed_date – fecha del cambio
- author_comment – comentario
Plantillas
Solicitud 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
El 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 el dns-rows-list solicitud.
Parámetros
- name – nombre de dominio – obligatorio
- row_id – ID del registro – obligatorio, obtenido de dns-rows-list
Valores de retorno
- 1000 = ok
- 2201= TLD no admitido
- 2202= nombre de dominio no válido o no admitido
- 2318= Esta acción no se puede realizar en un dominio de tipo secundario
- 3222= error al abrir el dominio
- 3223= acceso denegado
- 3305= el dominio está bloqueado para su edición
- 3306= el dominio está eliminado
- 3309= no existe el registro DNS necesario para el dominio
Datos de retorno
- row – registro
- ID – ID del registro
- name – nombre del registro
- ttl – TTL del registro
- rdtype – tipo de registro
- rdata – datos del registro
- changed_date – fecha del cambio
- author_comment – comentario
Plantillas
Solicitud JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-detail",
"clTRID": "your ID",
"data": {
"name": "název domény",
"row_id": "ID záznamu"
}
}
}
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
El dns-row-add añade un nuevo registro DNS al dominio.
Parámetros
- dominio – nombre de dominio – obligatorio
- name – nombre del registro – obligatorio, pero puede estar vacío
- ttl – valor TTL – obligatorio
- type – tipo de registro – obligatorio
- rdata – datos del registro – obligatorio
- author_comment – comentario del autor – opcional. Enviar una cadena vacía borra el comentario anterior.
Valores de retorno
- 1000 = ok
- 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 un dominio de tipo secundario
- 3222= error al abrir el dominio
- 3223= acceso denegado
- 3305= el dominio está bloqueado para su edición
- 3306= el dominio está eliminado
- 3307 = error al añadir el registro del dominio
- 5001 = error interno de autenticación
Datos de retorno
La solicitud no devuelve datos.
Plantillas
Solicitud 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"
}
}
}
Solicitud JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-add",
}
}
dns-row-update
Utilice el dns-row-update para modificar un registro DNS.
No puede cambiar el nombre ni el tipo de un registro. En tal caso, eliminar el registro original y a continuación crear una nueva.
Parámetros
- dominio – nombre de 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. Enviar una cadena vacía borra el comentario anterior.
Valores de retorno
- 1000 = ok
- 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 un dominio de tipo secundario
- 3222= error al abrir el dominio
- 3223= acceso denegado
- 3305= el dominio está bloqueado para su edición
- 3306= el dominio está eliminado
- 3310 = error al actualizar el registro del dominio
- 5001 = error interno de autenticación
Datos de retorno
La solicitud 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 el dns-row-delete para eliminar un registro DNS de un dominio.
Parámetros
- dominio – nombre de dominio – obligatorio
- row_id – ID del registro – obligatorio, obtenido de dns-rows-list
Valores de retorno
- 1000 = ok
- 2201= TLD no admitido
- 2202= nombre de dominio no válido o no admitido
- 2318= acción no válida para un dominio de tipo secundario
- 3222= error al abrir el dominio
- 3223= acceso denegado
- 3305= el dominio está bloqueado para su edición
- 3306= el dominio está eliminado
- 3308= error al eliminar el registro
- 3309= no existe ningún registro con este ID
Datos de retorno
La solicitud no devuelve datos.
Plantillas
Solicitud JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-delete",
"clTRID": "your ID",
"data": {
"domain": "domain name",
"row_id": "record ID"
}
}
}
Solicitud 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 comentario!