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:
- domains-list - lista de dominios en la cuenta del cliente
- domain-check - comprueba si el dominio está disponible
- domain-create - registrar un nuevo dominio
- domain-info - obtener información sobre el dominio
- domain-renew - renovar dominio
- domain-update-ns - cambiar los servidores DNS del dominio
- domain-transfer-check - comprobar disponibilidad de transferencia
- domain-transfer - transferir dominio desde otro registrador
- domain-send-auth-info - enviar AUTH-ID de dominio
- domain-tld-period-check - comprobar la disponibilidad del periodo
lista de dominios
La petición domains-list devuelve una lista de todos los dominios de la cuenta del cliente y su estado. También devuelve los nombres de los dominios eliminados. Si un dominio tiene más de una orden asignada, la petición lo devolverá varias veces con el estado apropiado (como eliminado).
Parámetros
- estado - filtrar por estado (opcional)
Los estados de dominio comunes incluyen:
- fee_waiting - en espera de pago
- setup_processing - creación en curso
- activo
- renew_processing - renovación en curso
- caducado
- desactivado
- cancelado
- transfer_fee_waiting - a la espera del pago de la transferencia
- transfer_processing - transferencia desde otro registrador en curso
- suprimido
Valores de retorno
- 1000 - OK
Datos de respuesta
El comando domains-list devuelve una lista de dominios, en la que cada dominio contiene las siguientes entradas:
- nombre - nombre de dominio
- status - estado del dominio
Plantillas
Solicitud 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"
}
}
}
}
}
comprobación de dominio
Utilice la solicitud de comprobación de dominio para verificar si podemos registrar un dominio.
La solicitud de comprobación de dominios está sujeta al límite de 100 consultas de dominios por hora.
No podemos registrar algunos dominios, aunque no existan actualmente. 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 las disputas en curso.
Parámetros
- name - nombre de dominio sin www - obligatorio
Valores de retorno
- 1000 - dominio disponible para registro
- 3201 - nombre de dominio ya utilizado
- 3204 - dominio en cuarentena
- 3205 - dominio reservado
- 3206 - el nombre de dominio está bloqueado
Datos de respuesta
Esta petición no devuelve más datos que el valor de retorno.
Plantillas
Solicitud JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "domain-check",
"clTRID": "your ID",
"data": {
"name": "your domain without www"
}
}
}
Respuesta JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "domain-check"
}
}
crear dominio
Utilice la solicitud domain-create para registrar un nuevo dominio. La solicitud es sincrónica o asincrónica, dependiendo del TLD del dominio.
La solicitud de creación de dominios está sujeta al límite de 100 consultas de dominios por hora.
Para todos los dominios, tanto nosotros como el registro exigimos el consentimiento del propietario del dominio a las normas de registro del nombre de dominio. Nuestras condiciones le obligan a familiarizar a sus clientes con nuestras condiciones y las del registrador del dominio. En caso contrario, el dominio podría ser retirado sin indemnización en caso de litigio.
Parámetros
- name - nombre de dominio, incluido el TLD - obligatorio
- periodo - número de años - requerido
- dns o nsset - una lista de servidores DNS o NSSET (sólo dominios CZ) - obligatorio
- owner_c - ID de contacto del propietario - obligatorio
- admin_c - ID de contacto del administrador - opcional
- normas - nombre y apellidos de la persona que ha aceptado nuestras condiciones y las del registro (normalmente el propietario del dominio)
Posibles valores del parámetro dns:
- Valor vacío del parámetro dns - utilizar el valor por defecto (servidores DNS WEDOS). Atención, aunque deje el parámetro DNS vacío, ¡tiene que especificarlo! El parámetro NSSET debe contener siempre un valor (por ejemplo
WEDOS). - Configuración DNS propia - no puede utilizarse para dominios CZ (cada registro debe contener un campo de nombre, opcionalmente addr_ip4 y addr_ip6, los servidores individuales se anidan en el elemento servidor). Véase la plantilla para más detalles.
Valores de retorno
- 1000 - el dominio se ha registrado correctamente
- 1001 - solicitud de registro asíncrono aceptada
- 3002 - crédito insuficiente en cuenta de crédito
- 3201 - nombre de dominio ya utilizado
- 3204 - dominio en cuarentena
- 3205 - dominio reservado
- 3206 - el nombre de dominio está bloqueado
- 2201 - TLD no compatible
- 2203 - período no válido
- 3221 - creación fallida
- 4207 - creación fallida - error de conexión
Datos de respuesta
Una vez registrado correctamente el dominio, se devuelven los siguientes elementos en el nodo de datos:
- num - número de pedido
- expiración - fecha de expiración del dominio
- crédito - estado de la cuenta de crédito una vez finalizada la operación
- importe - saldo acreedor
- divisa - moneda
Plantillas
Solicitud JSON con WEDOS NSSET:
{
"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"
}
}
}
}
Solicitud 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"
}
}
}
dominio-info
Utilice la petición domain-info para obtener información sobre un dominio específico.
El comando sólo funciona en los dominios de la cuenta de cliente correspondiente.
Parámetros
- name - nombre de dominio sin www - obligatorio
Valores de retorno
- 1000 - el comando se ha ejecutado correctamente, los datos del elemento contienen información sobre el dominio
- 3222 - Error al recuperar el objeto de dominio
- 3216 - Error al recuperar información sobre el dominio
- 3223 - el dominio no pertenece a su cuenta de cliente
- 4205 - error en relación con el registro
Datos de respuesta
El elemento de datos contiene información sobre el dominio en caso de éxito. Los datos específicos dependen del tipo de dominio y de otras circunstancias. Éstos son los más importantes:
- nombre - nombre de dominio
- status - estado del dominio
- owner_c - ID del propietario del dominio
- setup_date - fecha de creación
- caducidad - fecha de caducidad
- dns o NSSET - Lista de servidores DNS o NSSET
- elementos con prefijo own_ - información sobre el propietario del dominio
Algunas informaciones sobre el dominio o su propietario pueden estar ocultas, en cuyo caso tienen el valor OCULTO.
Plantillas
Solicitud JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "domain-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-info",
"data": {
"domain": {
"name": "domain.tld",
"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": ""
}
}
}
}
}
renovar dominio
La solicitud de renovación de dominio le permite renovar un dominio que aún no tiene una renovación ordenada.
El sistema intenta renovar automáticamente los dominios 30 días antes de su expiración.
Parámetros
- nombre - nombre de dominio - obligatorio
- periodo - número de años a renovar - obligatorio
Valores de retorno
- 1000 - El dominio se ha renovado correctamente
- 2203 - Período de renovación no válido
- 2269 - la solicitud de renovación ya existe
Datos de respuesta
Si tiene éxito, este comando devuelve la nueva fecha de caducidad.
- expiración - nueva fecha de expiración del dominio
Plantillas
Solicitud 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
Utiliza la petición domain-update-ns para cambiar los servidores DNS del dominio o NSSET.
Parámetros
- nombre - nombre de dominio - obligatorio
- dns o nsset - Servidores DNS o NSSET para dominios CZ - obligatorio
Posibles valores del parámetro dns:
- Valor vacío del parámetro dns - utilizar el valor por defecto (servidores DNS WEDOS). Atención, aunque deje el parámetro DNS vacío, ¡tiene que especificarlo! El parámetro NSSET debe contener siempre un valor (por ejemplo
WEDOS). - Configuración DNS propia - no puede utilizarse para dominios CZ (cada registro debe contener un campo de nombre, opcionalmente addr_ip4 y addr_ip6, los servidores individuales se anidan en el elemento servidor). Véase la plantilla para más detalles.
Valores de retorno
- 1000 - Servidores DNS configurados correctamente
- 2209 - formato NSSET no válido (para dominios CZ)
- 2210 - formato de servidor DNS no válido
Datos de respuesta
La solicitud no devuelve ningún dato.
Plantillas
Solicitud 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",
}
}
comprobación de transferencia de dominio
Utilice la solicitud de comprobación de transferencia de dominio para comprobar si el dominio puede transferirse de otro registrador a nosotros.
La dirección comprobación de transferencia de dominio está sujeto al límite de 100 consultas de dominio por hora.
Parámetros
- name - nombre de dominio sin www - obligatorio
Valores de retorno
La solicitud suele devolver los siguientes valores:
- 1000 - La transferencia es posible
- 3217 - No se ha podido establecer una conexión con el registro
- 3218 - La transferencia no es posible
Datos de respuesta
La solicitud no devuelve ningún dato.
Plantillas
Solicitud JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "domain-transfer-check",
"clTRID": "your ID",
"data": {
"name": "domain.tld"
}
}
}
JSON odpověď (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "domain-transfer-check"
}
}
transferencia de dominio
Utilice la solicitud de transferencia de dominio para transferir un dominio de otro registrador a WEDOS.
La solicitud es sincrónica sólo para los dominios CZ y EU, es decir, para ellos, si el AUTH-ID es correcto, la transferencia se realiza inmediatamente y usted conoce el resultado enseguida. Para el resto de dominios, las transferencias son asíncronas, por lo que conocerá el resultado a través de una notificación.
El sitio transferencia de dominio está sujeto al límite de 100 consultas de dominio por hora.
Para todos los dominios, tanto nosotros como el registro exigimos el consentimiento del propietario del dominio a las normas de registro del nombre de dominio. Nuestras condiciones le obligan a familiarizar a sus clientes con nuestras condiciones y las del registrador del dominio. En caso contrario, el dominio podría ser retirado sin indemnización en caso de litigio.
Parámetros
- name - nombre de dominio sin www - obligatorio
- auth_info - dominio AUTH-ID - obligatorio
- owner_c - ID del propietario del dominio - obligatorio sólo para algunos registros (SK, EU, gTLD)
- dns - configuración del servidor DNS del dominio - opcional; disponible sólo para registros que lo soporten (EU, gTLD)
- reglas - nombre y apellidos de la persona que ha aceptado nuestros términos y condiciones y los términos del registro (normalmente el propietario del dominio) - obligatorio
Valores disponibles del parámetro dns:
- Parámetro DNS omitido: el dominio conservará la configuración actual del servidor DNS. Durante la transferencia, se resolverán los servidores DNS actuales. Si no es posible resolver los servidores DNS actuales, la transferencia puede dar lugar a un error (gTLD).
- Parámetro DNS vacío - el sistema intentará establecer servidores DNS WEDOS por defecto.
- Parámetro DNS con servidores - el sistema intentará configurar estos servidores DNS.
Valores de retorno
- 1000 - Dominio transferido correctamente
- 1001 - Se ha aceptado la solicitud de transferencia, pendiente de ejecución
- 2100 - Falta el parámetro requerido
- 2101 - Valor de parámetro no válido
- 2201 - TLD no válido
- 2202 - Formato de nombre de dominio no válido
- 2204 - Identificador de contacto del propietario del dominio no especificado
- 2207 - Identificador de contacto del propietario del dominio no válido
- 2210 - Formato de servidor DNS no válido
- 2215 - AUTH-ID no se ha especificado y es necesario para este dominio
- 2245 - Falta el consentimiento
- 2246 - Error en los datos de consentimiento
- 2252 - Solicitudes de dominio excedidas
- 2263 - AUTH-ID es más corto que la longitud mínima requerida
- 2271 - Formato AUTH-ID no válido
- 3001 - Moneda de la cuenta de crédito no válida
- 3003 - Información de facturación de la cuenta de crédito no válida
- 3207 - Dominio ya registrado con nosotros
- 3208 - Transferencia fallida debido a un problema con la fecha de caducidad
- 3217 - No se ha podido establecer una conexión con el registro
- 3218 - Transferencia imposible
- 3219 - Solicitud de transferencia ya pendiente para este dominio
- 3220 - Dominio ya registrado en nuestro registro
- 3226 - No se ha podido transferir el dominio
- 3227 - Error de autorización en el registro de dominios
- 3258 - Tiempo de inactividad del registro
- 3266 - No se puede transferir porque el dominio ha caducado
- 3267 - Fallo en la resolución de los servidores DNS autorizados
- 4002 - No se ha podido deducir el crédito de la cuenta de crédito
- 4003 - Error al crear periodo de facturación
- 4206 - No se ha podido determinar si se puede transferir el dominio - error de conexión
- 4209 - No se ha podido determinar el tipo de transferencia (con / sin renovación)
- 5001 - Error interno de inicio de sesión
- 5002 - No se ha podido calcular el precio de transferencia
- 5004 - Tiempo de inactividad en la facturación
Datos de respuesta
- num - número de pedido
- expiración - fecha de expiración del dominio
Plantillas
Solicitud 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 la solicitud domain-send-auth-info para enviar el AUTH-ID de un dominio al correo electrónico del propietario del dominio.
Parámetros
- nombre - nombre de dominio - obligatorio
Valores de retorno
- 1000 - AUTH-ID se envía al correo electrónico del propietario del dominio
- 2243 - No se permite enviar auth_info
- 3209 - Error al enviar auth_info
- 3210 - Fallo al enviar auth_info - el dominio no está disponible
- 3222 - No se ha podido recuperar el dominio
- 3223 - El dominio no pertenece a esta cuenta de cliente
- 4214 - No se ha podido enviar auth_info - error de conexión - inténtelo de nuevo más tarde
Datos de respuesta
La solicitud no devuelve ningún dato.
Plantillas
Solicitud 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-tld-period-check
Utilice la solicitud domain-tld-period-check para comprobar si se puede establecer un periodo de registro determinado para un TLD.
Parámetros
- tld - TLD
- periodo - número de años
Valores de retorno
- 1000 - periodo que puede utilizarse para este dominio
- 2203 -period no puede utilizarse para este dominio
Datos de respuesta
La solicitud no devuelve ningún dato.
Plantillas
JSON příkaz:
{
"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"
}
}