Este artículo trata de los comandos WAPI específicos para el servicio DNS de WEDOS. Para obtener información sobre cómo configurar WAPI y solucionar problemas comunes, consulte el artículo WAPI - Manual.
Este artículo ofrece información sobre las siguientes solicitudes:
- dns-domains-list - lista de dominios DNS en la cuenta del usuario
- dns-domain-info - información sobre el dominio
- dns-domain-add - añadir dominio a DNS
- dns-domain-update - actualizar dominio en DNS
- dns-domain-delete - eliminar dominio del DNS
- dns-domain-axfr-run - solicitar 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 a DNS copiando otro dominio
- dns-domain-commit - guardar cambios DNS
- dns-rows-list - recuperar lista de registros de dominio
- dns-row-detail - recuperar detalle de registro
- dns-row-add - añadir registro
- dns-row-update - editar registro
- dns-row-delete - borrar registro
dns-domains-list
Utilice la petición dns-domains-list para listar los dominios DNS del usuario.
Parámetros
- search - cadena para buscar entre los nombres de dominio - opcional
- estado - filtrar por estado (activo, desactivado) - opcional
- type - filtrar por tipo de dominio (primario, secundario) - opcional
- page - número de página (por defecto: 1) - opcional
- page_limit - número de entradas por página (por defecto: 50) - opcional
- orderby - ordena las entradas por created_date o domain, seguido de asc/desc - opcional, ver plantilla
Valores de retorno
- 1000 - OK
Datos de respuesta
La petición devuelve una lista de dominios que utilizan esta plantilla:
- dominio
- nombre - nombre de dominio
- status - estado del dominio en el sistema
- tipo - tipo (primario/secundario)
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 la petición dns-domain-info para encontrar información básica sobre uno o más dominios en el sistema WEDOS DNS (WDNS).
Parámetros
- name - nombre de dominio, para varios dominios utilice una cadena separada por comas (consulte la plantilla) - obligatorio
Valores de retorno
- 1000 = OK
- 2201 = TLD no soportado
- 2202 = nombre de dominio no válido
- 3222 = no se ha podido abrir el dominio
- 3223 = error de autorización
- 3305 = dominio bloqueado para edición
- 3306 = dominio eliminado
El valor de retorno para múltiples dominios es siempre 1000. Cualquier valor de error se muestra en los datos del dominio, como se muestra en la plantilla.
Devolver datos
Si tiene éxito, la petición devuelve el detalle del dominio en WDNS en el nodo datos/dominio.
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 (dominio.nombre1 OK, dominio.nombre2 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 a DNS.
Parámetros
- nombre: nombre de dominio o varios nombres separados por comas (obligatorio)
- type - tipo de registro de dominio (primario/secundario) - opcional (por defecto: primario)
- axfr_enabled - ¿está activado el axfr saliente? (0/1) - sólo dominios primarios, opcional (por defecto: 0)
- axfr_ips - lista de direcciones ip habilitadas para axfr (sólo 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á habilitado TSIG? (0/1) - sólo dominios secundarios, opcional
- primary_tsig_name - Identificador TSIG - sólo dominios secundarios, obligatorio si TSIG está activado
- primary_tsig_alg - Algoritmo TSIG - sólo dominios secundarios, obligatorio si TSIG está activado
- primary_tsig_key - Clave TSIG - sólo dominios secundarios, necesaria si TSIG está activado
- template_id - ID de un dominio de tipo plantilla - sólo dominio primario, opcional
Valores de retorno
- 1000 = ok
- 2007 = se ha superado el tamaño máximo de solicitud
- 2100 = falta el parámetro requerido
- 2101 = parámetros de entrada no válidos
- 2201 = TLD no soportado
- 2202 = nombre de dominio no válido
- 2301 = formato de tipo incorrecto
- 2302 = falta el parámetro primary_ip
- 2303 = formato incorrecto de primary_ip
- 2304 = formato no válido axfr_enabled
- 2305 = falta el parámetro requerido axfr_ips
- 2306 = formato no válido de axfr_ips
- 2308 = formato no válido de ns
- 2322 = límite alcanzado de dominios en el DNS por usuario
- 2323 = plantilla no encontrada
- 2324 = no se puede crear el dominio primario a través de la plantilla
- 2325 = plantilla indefinida
- 2330 = Petición inválida - dominio WDNS - TSIG primario - configuración inválida
- 2331 = Petición inválida - dominio WDNS - TSIG primario - formato de nombre inválido
- 2332 = Petición inválida - dominio WDNS - TSIG primario - formato de algoritmo inválido
- 2333 = Petición inválida - dominio WDNS - TSIG primario - formato de clave inválido
- 2340 = número máximo de dominios con acción única excedido
- 3302 = error al añadir dominio a DNS
- 3303 = el dominio ya existe en DNS
Devolver datos
La solicitud no devuelve ningún dato.
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 múltiples 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 DNS.
Parámetros
- nombre: nombre de dominio o varios nombres separados por comas (obligatorio)
- axfr_enabled - ¿está activado el axfr saliente? (0/1) - sólo dominios primarios, opcional (por defecto: 0)
- axfr_ips - lista de direcciones ip habilitadas para axfr (sólo para la entrada primaria, necesaria si axfr_enabled=1)
- ip - dirección ip para axfr saliente
- primary_ip - direcciones ip del servidor dns primario (obligatorio si type=secondary)
- primary_tsig_enabled - ¿está habilitado TSIG? (0/1) - sólo dominios secundarios, opcional
- primary_tsig_name - Identificador TSIG - sólo dominios secundarios, obligatorio si TSIG está activado
- primary_tsig_alg - Algoritmo TSIG - sólo dominios secundarios, obligatorio si TSIG está activado
- primary_tsig_key - Clave TSIG - sólo dominios secundarios, necesaria si TSIG está activado
Valores de retorno
- 1000 = ok
- 2007= se ha superado el tamaño máximo de solicitud
- 2100 = falta el parámetro requerido
- 2101 = parámetros de entrada no válidos
- 2201 = TLD no soportado
- 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 axfr_enabled
- 2305 = falta el parámetro requerido axfr_ips
- 2306 = formato no válido de axfr_ips
- 2308 = formato no válido de ns
- 2322 = límite alcanzado de dominios en el DNS por usuario
- 2330 = Petición inválida - dominio WDNS - TSIG primario - configuración inválida
- 2331 = Petición inválida - dominio WDNS - TSIG primario - formato de nombre inválido
- 2332 = Petición inválida - dominio WDNS - TSIG primario - formato de algoritmo inválido
- 2333 = Petición inválida - dominio WDNS - TSIG primario - formato de clave inválido
- 2340= número máximo de dominios con acción única excedido
- 3302 = error al añadir dominio a DNS
- 3303 = el dominio ya existe en DNS
Devolver datos
La solicitud no devuelve ningún dato.
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 múltiples dominios (correcta):
{
"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 de DNS, incluyendo todos sus registros.
Parámetros
- nombre: nombre de dominio o varios nombres separados por comas (obligatorio)
Valores de retorno
- 1000 = ok
- 2007= se ha superado el tamaño máximo de solicitud
- 2340= número máximo de dominios con acción única excedido
- 3222 = fallo al abrir el dominio
- 3223 = acceso denegado
- 3301 = no se puede eliminar el registro
- 3305 = dominio bloqueado para edición
- 3306 = dominio eliminado
Devolver datos
La solicitud no devuelve ningún dato.
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 múltiples dominios (correcta):
{
"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 vía AXFR lo antes posible (en pocos minutos). Se utiliza para dominios secundarios, en los que 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
- nombre - nombre de dominio - obligatorio
Valores de retorno
- 1000 = ok
- 2201 = TLD no soportado
- 2202 = nombre de dominio no válido o no admitido
- 2319 = sólo puede hacerse para el tipo de dominio secundario
- 3222 = fallo al abrir el dominio
- 3223 = acceso denegado
- 3305 = dominio bloqueado para edición
- 3306 = dominio eliminado
Devolver datos
- next_run - hora de la próxima 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-dominio-axfr-tsig
La solicitud dns-domain-axfr-tsig se utiliza para crear/actualizar, eliminar o mostrar información clave AXFR TSIG para uno o más 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á necesaria para todas las transferencias a servidores DNS secundarios y debe coincidir exactamente con su configuración.
Si el servidor principal no utiliza TSIG, no habilite esta opción, ya que la transferencia AXFR fallará.
Parámetros
- nombre: nombre de dominio o varios nombres separados por comas (obligatorio)
- axfr_tsig_acción – Acción AFXR TSIG: obligatoria.
- Crear: habilitar o actualizar AXFR TSIG.
- Cancelar: desactivar AXFR TSIG
- info – mostrar información AXFR TSIG
Valores de retorno
- 1000 = ok
- 2201 = TLD no soportado
- 2202 = nombre de dominio no válido o no admitido
- 2319 = sólo puede hacerse para el tipo de dominio 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 con acción única excedido
- 3222 = fallo al abrir el dominio
- 3223 = acceso denegado
- 3305 = dominio bloqueado para edición
- 3306 = dominio eliminado
Devolver datos
- nombre = 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 clave AXFR TSIG
- axfr_tsig_key – Valor 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 para el 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 comando dns-domain-copy para añadir un dominio a DNS copiando la configuración y los registros de otro existente.
Parámetros
- name - nombre del dominio original (el que desea copiar) - obligatorio
- name_new - nombre del dominio recién creado - obligatorio
Valores de retorno
- 1000 = ok
- 2201 = TLD no soportado
- 2202 = nombre de dominio existente no válido o no admitido
- 2320 = nombre no válido o no compatible del nuevo dominio
- 2321 = TLD no soportado del nuevo nombre de dominio
- 2322 = límite alcanzado del número de dominios en el DNS por usuario
- 3222 = fallo al abrir el dominio
- 3223 = acceso denegado
- 3305 = dominio bloqueado para edición
- 3306 = dominio eliminado
- 3311 = copia fallida
- 3312 = el nuevo dominio ya existe en DNS
Devolver datos
La solicitud no devuelve ningún dato.
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 la petición 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 comando dns-domain-commit, el sistema lo realizará automáticamente 5 minutos después del último cambio.
Parámetros
- nombre - nombre de dominio - obligatorio
Valores de retorno
- 1000 = ok
- 2201 = TLD no soportado
- 2202 = nombre de dominio no válido o no soportado
- 3222 = fallo al abrir el dominio
- 3223 = acceso denegado
- 3305 = dominio bloqueado para edición
- 3306 = dominio eliminado
Devolver datos
La solicitud no devuelve ningún dato.
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 la petición dns-rows-list para obtener una lista de registros de dominio en DNS junto con 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 de dominio - obligatorio
Valores de retorno
- 1000 = ok
- 2201 = TLD no soportado
- 2202 = nombre de dominio no válido o no soportado
- 2318 = no se puede realizar en el tipo de dominio secundario
- 3222 = fallo al abrir el dominio
- 3223 = acceso denegado
- 3305 = dominio bloqueado para edición
- 3306 = dominio eliminado
Datos de respuesta
- fila - registro
- ID - ID del registro
- name - nombre del registro
- ttl - TTL de registro
- rdtype - tipo de registro
- rdata - registro de datos
- changed_date - fecha de modificación
- 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
La petición dns-row-detail devuelve información detallada sobre un registro DNS de dominio específico.
Para obtener una lista completa de los registros de un dominio, utilice la petición dns-rows-list.
Parámetros
- nombre - nombre de dominio - obligatorio
- row_id - ID del registro - obligatorio, obtenido de dns-rows-list
Valores de retorno
- 1000 = ok
- 2201 = TLD no soportado
- 2202 = nombre de dominio no válido o no soportado
- 2318 = Esta acción no puede realizarse en el tipo de dominio secundario
- 3222 = fallo en la apertura del dominio
- 3223 = acceso denegado
- 3305 = dominio bloqueado para edición
- 3306 = dominio eliminado
- 3309 = el registro DNS necesario para el dominio no existe
Devolver datos
- fila - registro
- ID - ID del registro
- name - nombre del registro
- ttl - TTL de registro
- rdtype - tipo de registro
- rdata - registro de datos
- changed_date - fecha de modificación
- 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
La petición 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 de registro - obligatorio
- auth_comment - comentario del autor - opcional
Valores de retorno
- 1000 = ok
- 2201 = TLD no soportado
- 2202 = nombre de dominio no válido o no soportado
- 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 no válidos del registro
- 2315 = TLD no válido
- 2316 = este registro ya existe
- 2317 = TTL no válido
- 2318 = no se puede realizar la acción en el tipo de dominio secundario
- 3222 = fallo en la apertura del dominio
- 3223 = acceso denegado
- 3305 = dominio bloqueado para edición
- 3306 = dominio eliminado
Devolver datos
La solicitud no devuelve ningún dato.
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 la petición dns-row-update para cambiar un registro DNS.
No puede cambiar el nombre y el tipo de un registro. En tal caso, elimine el registro original y cree uno nuevo.
Parámetros
- dominio - nombre de dominio - obligatorio
- row_id - ID del registro - obligatorio, obtenido de dns-rows-list
- ttl - Valor TTL - obligatorio
- rdata - datos de registro - obligatorio
Valores de retorno
- 1000 = ok
- 2201 = TLD no soportado
- 2202 = nombre de dominio no válido o no soportado
- 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 este tipo de registro
- 2313 = CNAME no válido para este título
- 2314 = registro de datos no válido
- 2315 = TLD no válido
- 2316 = este registro ya existe
- 2317 = TTL no válido
- 2318 = no se puede realizar la acción en el tipo de dominio secundario
- 3222 = fallo al abrir el dominio
- 3223 = acceso denegado
- 3305 = dominio bloqueado para edición
- 3306 = dominio eliminado
- 3309 = el registro de ese ID no existe
- 3310 = modificación de registro fallida
Devolver datos
La solicitud no devuelve ningún dato.
Plantillas
JSON příkaz:
{
"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 de dominio - obligatorio
- row_id - ID del registro - obligatorio, obtenido de dns-rows-list
Valores de retorno
- 1000 = ok
- 2201 = TLD no soportado
- 2202 = nombre de dominio no válido o no soportado
- 2318 = acción no válida para el tipo de dominio secundario
- 3222 = fallo en la apertura del dominio
- 3223 = acceso denegado
- 3305 = dominio bloqueado para edición
- 3306 = dominio eliminado
- 3308 = fallo en la eliminación del registro
- 3309 = el registro con este ID no existe
Devolver datos
La solicitud no devuelve ningún dato.
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",
}
}
¿Te ha resultado útil?
Gracias por sus comentarios.