WAPI – Dominios

Este artículo trata de 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 peticiones:

domains-list

El domains-list devuelve una lista de todos los dominios de la cuenta de cliente y su estado. También devuelve los nombres de los dominios eliminados. Si un dominio tiene más de un pedido asignado, la solicitud lo devolverá varias veces con el estado correspondiente (como eliminado).

Parámetros

  • status – filtrar por estado (opcional)

Los estados habituales de un dominio son:

  • fee_waiting – a la espera de pago
  • setup_processing – creación en curso
  • active
  • renew_processing – renovación en curso
  • expired
  • disabled
  • canceled
  • transfer_fee_waiting – a la espera del pago de la transferencia
  • transfer_processing – transferencia de otro registrador en curso
  • deleted

Valores devueltos

  • 1000 – OK

Datos de respuesta

El comando domains-list devuelve una lista de dominios, en la que cada dominio contiene las siguientes entradas:

  • name – nombre del dominio
  • status – estado del dominio

Plantillas

Requerimiento JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domains-list",
    "clTRID": "your ID",
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domains-list",
    "data": {
      "domain": {
        "1": {
          "name": "domain1.tld",
          "status": "status"
         },
         "0": {
          "name": "domain2.tld",
          "status": "status"
        }
      }
    }
  }
}

domain-check

Utilice el domain-check solicitud para verificar si podemos registrar un dominio.

El domain-check esta solicitud está sujeta al límite de 100 consultas de dominio por hora.

Algunos dominios no podemos registrarlos, aunque actualmente no existan. Los nombres pueden estar reservados, bloqueados o su registro puede estar restringido de alguna otra forma. Siempre depende del registro concreto, de sus normas o de disputas en curso.

Parámetros

  • name – nombre del dominio sin www, o varios dominios separados por comas

Valores devueltos

  • 1000 – el dominio está disponible para registro, o solicitud devuelta (código de respuesta para solicitudes con varios dominios)
  • 3201 – el nombre de dominio ya está en uso
  • 3204 – el dominio está en cuarentena
  • 3205 – el dominio está reservado
  • 3206 – el nombre de dominio está bloqueado

Datos de respuesta

  • name – nombre del dominio
  • code – valor devuelto para ese dominio; solo se incluye en data si la solicitud consulta varios dominios
  • result – valor de texto del código de respuesta; solo se incluye en data si la solicitud consulta varios dominios

Plantillas

Requerimiento JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-check",
    "clTRID": "your ID",
    "data": {
      "name": "your domain without www, or multiple comma-separated domains"
    }
  }
}

Respuesta JSON para un único dominio (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-check",
    "data": {
      "name": "your domain without www"
    }
  }
}

Respuesta JSON para varios dominios (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-check"
    "data":[
        {
          "name":"existing-domain.tld",
          "code":3201,
          "result":"Domain is registered"
        },
        {
          "name":"free-domain.tld",
          "code":1000,
          "result":"OK"
        }
      ]
    }
  }
}

domain-create

Utilice el domain-create solicitud para registrar un nuevo dominio. La solicitud es síncrona o asíncrona, según el TLD del dominio.

El domain-create esta solicitud está sujeta al límite de 100 consultas de dominio por hora.

Para todos los dominios, nosotros y el registro exigimos la aceptación por parte del titular del dominio de las normas de registro de nombres de dominio. Nuestros términos y condiciones le obligan a informar a sus clientes de nuestras condiciones y de las condiciones del registrador de dominios. No hacerlo puede provocar la retirada del dominio sin compensación en caso de disputa.

Parámetros

  • name – nombre del dominio incluido el TLD – obligatorio
  • period – número de años – obligatorio
  • dns o nsset – una lista de servidores DNS o NSSET (solo dominios CZ) – obligatorio
  • owner_c – ID del contacto titular – obligatorio
  • admin_c – ID del contacto administrativo – opcional
  • reglas – nombre y apellidos de la persona que aceptó nuestras condiciones y las condiciones del registro (normalmente el titular del dominio)

Posible dns valores del parámetro:

  • Valor vacío del parámetro dns – se usa el valor predeterminado (servidores DNS de WEDOS). Atención: aunque deje vacío el parámetro DNS, ¡igualmente debe indicarlo! El parámetro NSSET siempre debe contener un valor (p. ej. WEDOS).
  • Configuración de DNS propio – no se puede usar para dominios CZ (cada registro debe contener un name campo, opcionalmente addr_ip4 y addr_ip6, los servidores individuales van anidados en el elemento server). Consulte la plantilla para más detalles.

Valores devueltos

  • 1000 – el dominio se ha registrado correctamente
  • 1001 – solicitud de registro asíncrona aceptada
  • 3002 – crédito insuficiente en la cuenta de anticipo
  • 3201 – el nombre de dominio ya está en uso
  • 3204 – el dominio está en cuarentena
  • 3205 – el dominio está reservado
  • 3206 – el nombre de dominio está bloqueado
  • 2201 – TLD no compatible
  • 2203 – periodo no válido
  • 3221 – fallo en la creación
  • 4207 – fallo en la creación – error de conexión

Datos de respuesta

Tras el registro correcto del dominio, se devuelven los siguientes elementos en el nodo data:

  • num – número de pedido
  • caducidad – fecha de expiración del dominio
  • crédito – estado de la cuenta de anticipo tras completarse la operación
    • amount – saldo de la cuenta de anticipo
    • currency – moneda

Plantillas

Requerimiento JSON con NSSET de WEDOS:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-create",
    "clTRID": "your ID",
    "data": {
      "name": "domain.cz",
      "period": "number of years",
      "nsset": "WEDOS",
      "owner_c": "owner contact ID",
      "admin_c": "admin contact ID",
      "rules": {
        "fname": "Name",
        "lname": "Surname"
      }
    }
  }
}

Requerimiento JSON con DNS propio:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-create",
    "clTRID": "your ID",
    "data": {
      "name": "domain.tld",
      "period": "number of years",
      "dns": {
        "server1":
          {
            "name": "ns1.dns-provider.tld"
          },
        "server2":
          {
            "name": "ns2.dns-provider.tld"
          }
        }
      },
      "owner_c": "domain owner contact ID",
      "admin_c": "domain admin contact ID",
      "rules": {
        "fname": "Name",
        "lname": "Surname"
      }
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-create",
    "data": {
      "num": "order number",
      "expiration": "YYYY-MM-DD"
    }
  }
}

domain-info

Utilice el domain-info solicitud para obtener información sobre un dominio concreto.

El comando solo funciona con dominios de la cuenta de cliente correspondiente.

Parámetros

  • name – nombre del dominio; para varios dominios use una cadena separada por comas (ver plantilla) – obligatorio

Valores devueltos

  • 1000 – el comando se ejecutó correctamente, el elemento data contiene información sobre el dominio
  • 3222 – no se pudo obtener el objeto de dominio 
  • 3216 – no se pudo obtener información sobre el dominio
  • 3223 – el dominio no pertenece a su cuenta de cliente
  • 4205 – error en la conexión con el registro

El valor devuelto para varios dominios siempre es 1000. Los valores de error se muestran en los datos de dominio , como se muestra en la plantilla.

Datos de respuesta

El elemento data contiene información sobre el dominio si la operación tiene éxito. Los datos concretos dependen del tipo de dominio y de otras circunstancias. Estos son los más importantes:

  • name – nombre del dominio
  • status – estado del dominio
  • owner_c – ID del titular del dominio
  • setup_date – fecha de creación
  • caducidad – fecha de expiración
  • dns o NSSET – lista de servidores DNS o NSSET
  • elementos con own_ prefijo: información del titular del dominio

Parte de la información sobre el dominio o su titular puede estar oculta; en tal caso tiene el valor HIDDEN.

Plantillas

Requerimiento JSON con 2 dominios:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "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": "domain-info",
    "data": {
      "domain": [{
        "name": "domain.name1",
        "status": "status",
        "owner_c": "owner ID",
        "nsset": "WEDOS",
        "reg_owner": "",
        "reg_creator": "",
        "setup_date": "YYYY-MM-DD",
        "expiration": "YYYY-MM-DD",
        "reg_update": "",
        "updated_date": "",
        "transfer_date": "",
        "dns": {
          "server1":
            {
              "name": "ns1.server-provider.tld"
            },
          "server2":
            {
              "name": "ns1.server-provider.tld"
            }
          }
        },
        "own_company": "",
        "own_name": "",
        "own_lname": "",
        "own_fname": "",
        "own_email": "",
        "own_email2": "",
        "own_phone": "",
        "own_fax": "",
        "own_ic": "",
        "own_dic": "",
        "own_taxpayer": "",
        "own_addr_street": "",
        "own_addr_city": "",
        "own_addr_zip": "",
        "own_addr_country": "",
        "own_addr_state": "",
        "admin_c": "",
        "own_other": {
          "notify_email": "",
          "ident_type": "",
          "ident": ""
        }
      },
      {
        "name": "domain.name2",
        "code": 3222,
        "result": "Domain open failed"
      }]
    }
  }
}

domain-renew

El domain-renew permite renovar un dominio que aún no tiene una renovación pedida.

De forma predeterminada, el sistema intenta renovar los dominios automáticamente 30 días antes de su expiración. Puede desactivar este comportamiento en su configuración de cuenta ⧉.

Parámetros

  • name – nombre del dominio – obligatorio
  • period – número de años a renovar – obligatorio

Valores devueltos

  • 1000 – el dominio se ha renovado correctamente
  • 2203 – periodo de renovación no válido
  • 2269 – la solicitud de renovación ya existe

Datos de respuesta

Si se realiza correctamente, este comando devuelve la nueva fecha de expiración.

  • caducidad – nueva fecha de expiración del dominio

Plantillas

Requerimiento JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-renew",
    "clTRID": "your ID",
    "data": {
      "name": "your domain name without www",
      "period": "number of years"
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-renew",
    "data": {
      "expiration": "YYYY-MM-DD"
    }
  }
}

domain-update-ns

Utilice el domain-update-ns solicitud para cambiar los servidores DNS o el NSSET del dominio.

Parámetros

  • name – nombre del dominio – obligatorio
  • dns o nsset – servidores DNS o NSSET para dominios CZ – obligatorio

Posible dns valores del parámetro:

  • Valor vacío del parámetro dns – se usa el valor predeterminado (servidores DNS de WEDOS). Atención: aunque deje vacío el parámetro DNS, ¡igualmente debe indicarlo! El parámetro NSSET siempre debe contener un valor (p. ej. WEDOS).
  • Configuración de DNS propio – no se puede usar para dominios CZ (cada registro debe contener un name campo, opcionalmente addr_ip4 y addr_ip6, los servidores individuales van anidados en el elemento server). Consulte la plantilla para más detalles.

Valores devueltos

  • 1000 – servidores DNS configurados correctamente 
  • 2209 – formato de NSSET no válido (para dominios CZ)
  • 2210 – formato de servidor DNS no válido

Datos de respuesta

La petición no devuelve datos.

Plantillas

Requerimiento JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-update-ns",
    "clTRID": "your ID",
    "data": {
      "name": "domain.tld",
      "dns": {
        "server1":
          {
            "name": "ns1.own-dns-server.tld"
          },
        "server2":
          {
            "name": "ns1.own-dns-server.tld"
          }
        }
      }
    }
  }  
}

Respuesta JSON (OK):

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

domain-transfer-check

Utilice el domain-transfer-check solicitud para comprobar si el dominio puede transferirse de otro registrador a nosotros.

El domain-transfer-check esta solicitud está sujeta al límite de 100 consultas de dominio por hora.

Parámetros

  • name – nombre del dominio sin www – obligatorio

Valores devueltos

La petición suele devolver los siguientes valores:

  • 1000 – la transferencia es posible
  • 3217 – no se pudo establecer conexión con el registro
  • 3218 – la transferencia no es posible

Datos de respuesta

La petición no devuelve datos.

Plantillas

Requerimiento JSON:

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

Respuesta JSON (OK):

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

domain-transfer

Utilice el domain-transfer solicitud para transferir un dominio de otro registrador a WEDOS.

La petición es síncrona solo para dominios CZ y EU, es decir, en su caso, si el AUTH-ID es correcto, la transferencia se realiza de inmediato y conoce el resultado al instante. Para el resto de dominios las transferencias son asíncronas, por lo que conocerá el resultado mediante una notificación.

El domain-transfer esta solicitud está sujeta al límite de 100 consultas de dominio por hora.

Para todos los dominios, nosotros y el registro exigimos la aceptación por parte del titular del dominio de las normas de registro de nombres de dominio. Nuestros términos y condiciones le obligan a informar a sus clientes de nuestras condiciones y de las condiciones del registrador de dominios. No hacerlo puede provocar la retirada del dominio sin compensación en caso de disputa.

Parámetros

  • name – nombre del dominio sin www – obligatorio
  • auth_info – AUTH-ID del dominio – obligatorio
  • owner_c – ID del titular del dominio – obligatorio solo para algunos registros (SK, EU, gTLD)
  • dns – configuración del servidor DNS del dominio – opcional; disponible solo para registros que lo admiten (EU, gTLD)
  • reglas – nombre y apellidos de la persona que aceptó nuestras condiciones y las condiciones del registro (normalmente el titular del dominio) – obligatorio

Valores disponibles del dns parámetro:

  • Parámetro DNS omitido – el dominio conservará la configuración actual de los servidores DNS. Durante la transferencia se resolverán los servidores DNS actuales. Si no es posible resolver los servidores DNS actuales, la transferencia puede terminar con un error (gTLD).
  • Parámetro DNS vacío – el sistema intentará establecer los servidores DNS predeterminados de WEDOS.
  • Parámetro DNS con servidores – el sistema intentará establecer estos servidores DNS.

Valores devueltos

  • 1000 – dominio transferido correctamente
  • 1001 – la solicitud de transferencia ha sido aceptada, pendiente de ejecución
  • 2100 – falta un parámetro obligatorio
  • 2101 – valor de parámetro no válido
  • 2201 – TLD no válido
  • 2202 – formato de nombre de dominio no válido
  • 2204 – no se ha especificado el identificador del contacto titular del dominio
  • 2207 – identificador de contacto titular del dominio no válido
  • 2210 – formato de servidor DNS no válido
  • 2215 – no se ha especificado el AUTH-ID y es obligatorio para este dominio
  • 2245 – falta el consentimiento
  • 2246 – error en los datos de consentimiento
  • 2252 – se ha superado el número de consultas de dominio
  • 2263 – el AUTH-ID es más corto que la longitud mínima exigida
  • 2271 – formato de AUTH-ID no válido
  • 3001 – moneda de la cuenta de anticipo no válida
  • 3003 – información de facturación de la cuenta de anticipo no válida
  • 3207 – el dominio ya está registrado con nosotros
  • 3208 – la transferencia falló por un problema con la fecha de expiración
  • 3217 – no se pudo establecer conexión con el registro
  • 3218 – transferencia no posible
  • 3219 – ya existe una solicitud de transferencia pendiente para este dominio
  • 3220 – el dominio ya está registrado en nuestro registro
  • 3226 – no se pudo transferir el dominio
  • 3227 – error de autorización en el registro de dominios
  • 3258 – interrupción del registro
  • 3266 – no se puede transferir porque el dominio ha expirado
  • 3267 – los servidores DNS autoritativos no pudieron resolverse
  • 4002 – no se pudo descontar el crédito de la cuenta de anticipo
  • 4003 – no se pudo crear el periodo de facturación
  • 4206 – no se pudo determinar si el dominio puede transferirse – error de conexión
  • 4209 – no se pudo determinar el tipo de transferencia (con / sin renovación)
  • 5001 – error interno de inicio de sesión
  • 5002 – no se pudo calcular el precio de la transferencia
  • 5004 – interrupción del sistema de facturación

Datos de respuesta

  • num – número de pedido
  • caducidad – fecha de expiración del dominio

Plantillas

Requerimiento JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-transfer",
    "clTRID": "your ID",
    "data": {
      "name": "domain.tld",
      "auth_info": "AUTH-ID",
      "dns": {
        "server1":
          {
            "name": "ns1.mydns.tld"
          },
        "server2":
          {
            "name": "ns2.mydns.tld"
          }
        }
      },
      "rules": {
        "fname": "Name",
        "lname": "Surname"
      }
   }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-transfer",
    "data": {
      "num": "order number",
      "expiration": "YYYY-MM-DD"
    }
  }
}

domain-send-auth-info

Utilice el domain-send-auth-info solicitud para enviar el AUTH-ID de un dominio al correo electrónico del titular del dominio.

Parámetros

  • name – nombre del dominio – obligatorio

Valores devueltos

  • 1000 – el AUTH-ID se envía al correo electrónico del titular del dominio 
  • 2243 – no está permitido enviar auth_info
  • 3209 – no se pudo enviar auth_info
  • 3210 – no se pudo enviar auth_info – el dominio no está disponible
  • 3222 – no se pudo obtener el dominio
  • 3223 – el dominio no pertenece a esta cuenta de cliente
  • 4214 – no se pudo enviar auth_info – error de conexión – inténtelo más tarde

Datos de respuesta

La petición no devuelve datos.

Plantillas

Requerimiento JSON:

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

Respuesta JSON (OK):

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

domain-update-keyset

El domain-update-keyset permite realizar cambios en la configuración del KEYSET del dominio, es decir, activar, desactivar o actualizar la configuración DNSSEC.

Parámetros

  • name – nombre del dominio – obligatorio
  • keyset – configuración del KEYSET – obligatorio
    0 = sin KEYSET / desactivar DNSSEC
    1 = nuestro KEYSET / nuestro DNSSEC (si el dominio usa nuestros servidores DNS y está configurado como primary)
    cadena = el nombre de su propio KEYSET (si el dominio no usa nuestros servidores DNS o está configurado como secundario)

Valores devueltos

  • 1000 = OK
  • 2202 = nombre de dominio existente no válido o no compatible
  • 2264 = nombre de KEYSET no válido
  • 2265 = sin soporte de DNSSEC
  • 2266 = acción no soportada para un dominio secondary
  • 2267 = acción no soportada para un dominio primary
  • 3260 = ya existe un pedido de DNSSEC pendiente
  • 3258 = indisponibilidad del registro en curso
  • 3263 = el dominio no usa nuestro DNS
  • 3222 = fallo al abrir el dominio
  • 3223 = acceso denegado
  • 3259 = El KEYSET no está disponible
  • 3262 = La configuración de DNSSEC ha fallado
  • 3264 = El KEYSET está bloqueado

Datos devueltos

La petición no devuelve datos.

Plantillas

Requerimiento JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-update-keyset",
    "clTRID": "your ID",
    "data": {
      "name": "domain name",
      "keyset": "0/1/string",
    }
  }
}

Respuesta JSON (OK):

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

domain-tld-period-check

Utilice el domain-tld-period-check solicitud para ver si se puede establecer un determinado periodo de registro para un TLD.

Parámetros

  • tld – TLD
  • period – número de años

Valores devueltos

  • 1000 – el periodo se puede usar para este dominio
  • 2203 –el periodo no se puede usar para este dominio

Datos de respuesta

La petición no devuelve datos.

Plantillas

Comando JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-tld-period-check",
    "clTRID": "your ID",
    "data": {
      "tld": "domain tld",
      "period": "number of years"
    }
  }
}

Respuesta JSON (OK):

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

¿Le ha resultado útil?

¡Gracias por su valoración!
Selectores genéricos
Solo coincidencias exactas
Buscar en el título
Buscar en el contenido
Selectores de tipo de entrada
Índice del artículo
Explorar categorías