REST API – Contactos de dominio

GET /contacts/check

Comprueba si un handle de contacto está libre para su uso y cuál es su estado en el registro.

Parámetros:

• tld – obligatorio, query, string – TLD para el que se comprueba el contacto
• cname – obligatorio, query, string – handle (identificador) del contacto
• reg_key – opcional, query, string – identificador de un registro concreto (si el TLD admite varios registros/modos)

Códigos de retorno:

• 1000 – el contacto está libre y se puede usar
• 2201 – TLD no válido
• 2216 – formato no válido del identificador de contacto
• 2218 – en este registro los contactos se generan automáticamente (no puede elegir el handle)
• 3228 – el registro no admite contactos
• 3231 – el contacto ya existe
• 3233 – el contacto no se puede usar
• 3234 – el contacto no se puede usar – cuarentena
• 3235 – el contacto no se puede usar – reservado
• 3236 – el contacto no se puede usar – bloqueado
• 3237 – el contacto ya está registrado con nosotros
• 4211 – la comprobación del contacto ha fallado – error de conexión

Datos de la respuesta: Ninguno – el resultado lo transmiten directamente los campos code/msg.

Ejemplo:

curl -X GET -H 'Authorization: Bearer <TOKEN>' \
  'https://api.wedos.com/v2/contacts/check?tld=eu&cname=CONTACT'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "a1b2c3f1"
}

GET /contacts/{cname}

Devuelve información detallada sobre un contacto.

Parámetros:

• cname – obligatorio, path – handle del contacto
• tld – obligatorio, query, string – TLD bajo el que se busca el contacto
• auth_info – opcional, query, string – el código de autorización del contacto (si se indica, debe coincidir con el código establecido en el objeto; de lo contrario se devuelve un error)
• reg_key – opcional, query, string – identificador de un registro concreto

Códigos de retorno:

• 1000 – OK
• 2201 – TLD indicado incorrectamente
• 2216 – error de sintaxis del identificador de contacto
• 3215 – código de autorización no válido (se ha indicado y no coincide)
• 3228 – el registro no admite contactos
• 3229 – error al cargar el contacto
• 3236 – el contacto está bloqueado
• 4212 – error de conexión
• 5001 – no hay ninguna sesión iniciada

Datos de la respuesta:

• contact – objeto con los datos del contacto:
  • contact_id, roid, status – identificador, ROID y estado del contacto en el registro
  • name, fname, lname, company – nombre/nombre de pila/apellidos, o razón social
  • addr_street, addr_city, addr_zip, addr_state, addr_country – dirección
  • phone, fax, email, email2 – datos de contacto
  • ic, dic, taxpayer – identificación de empresa (IČ), identificación fiscal (DIČ), condición de pagador del IVA
  • reg_owner, reg_creator, reg_update – identificadores del registrador
  • created_date, updated_date, transfer_date – fechas de creación/actualización/transferencia
  • disclose – configuración de divulgación de datos (según el registro)
  • other – datos adicionales específicos del registro

Ejemplo:

curl -X GET -H 'Authorization: Bearer <TOKEN>' \
  'https://api.wedos.com/v2/contacts/CONTACT?tld=eu'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "a1b2c3f2",
  "data": {
    "contact": {
      "contact_id": "CONTACT",
      "status": "ok",
      "fname": "Esmeralda",
      "lname": "Excavadora",
      "company": null,
      "addr_street": "Street 123",
      "addr_city": "City",
      "addr_zip": "11000",
      "addr_country": "CZ",
      "phone": "+420.777123456",
      "email": "esmeralda@wedos.com",
      "created_date": "2024-01-10",
      "updated_date": null
    }
  }
}

POST /contacts/create

Crea un contacto de dominio nuevo para el TLD indicado.

Parámetros:

• tld – obligatorio, string – TLD para el que se crea el contacto
• reg_key – opcional, string – identificador de un registro concreto
• contact – obligatorio, object – datos del contacto; los campos disponibles difieren según el registro, normalmente:
  • cname (opcional) – handle de contacto solicitado; omítalo en los registros que generan los handles automáticamente
  • fname, lname – nombre y apellidos (para una persona física)
  • company – razón social (para una persona jurídica)
  • addr_street, addr_city, addr_zip, addr_state, addr_country – dirección
  • phone, fax, email, email2 – datos de contacto
  • ic, dic, taxpayer – identificación de empresa (IČ), identificación fiscal (DIČ), condición de pagador del IVA
  • otros elementos según el registro concreto

Códigos de retorno:

• 1000 – contacto creado
• 2100 – falta un parámetro obligatorio
• 2101 – parámetros de entrada no válidos
• 2201 – TLD no válido
• 2216 – nombre de contacto no válido
• 2218 – en este registro los nombres de contacto se crean automáticamente (no puede indicar uno propio)
• 2219–2242 – faltan elementos concretos del contacto o su formato no es válido (razón social, nombre, apellidos, correo electrónico, teléfono, fax, identificación de empresa, identificación fiscal, dirección, región, otros datos)
• 3228 – el registro no admite contactos
• 3230 – la creación del contacto ha fallado
• 3231 – el nombre de contacto ya está en uso
• 3233 – el contacto no se puede usar
• 3234 – el contacto no se puede usar – cuarentena
• 3236 – el contacto no se puede usar – bloqueado
• 3237 – el contacto ya está registrado con nosotros
• 4211 – la comprobación ha fallado – error de comunicación
• 4213 – la creación del contacto ha fallado – error de comunicación

Datos de la respuesta:

• cname – handle del contacto creado

Ejemplo:

curl -X POST -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' \
  'https://api.wedos.com/v2/contacts/create' \
  --data '{
    "tld": "eu",
    "contact": {
      "fname": "Esmeralda",
      "lname": "Excavadora",
      "addr_street": "Street 123",
      "addr_city": "City",
      "addr_zip": "11000",
      "addr_country": "CZ",
      "email": "esmeralda@wedos.com",
      "phone": "+420.777123456"
    }
  }'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "a1b2c3f3",
  "data": {
    "cname": "CONTACT"
  }
}

POST /contacts/{cname}/transfer

Transfiere un contacto a nosotros desde otro registrador (solo en los registros que admiten la transferencia de contactos, p. ej. CZ.NIC).

Parámetros:

• cname – obligatorio, path – handle del contacto
• tld – obligatorio, string – TLD
• auth_info – obligatorio, string – el código de autorización del contacto
• reg_key – opcional, string – identificador de un registro concreto

Códigos de retorno:

• 1000 – OK
• 2100 – falta un parámetro obligatorio
• 2101 – parámetros de entrada no válidos
• 2201 – TLD no válido
• 2215 – parámetro auth_info no indicado
• 2216 – identificador de contacto no válido
• 2244 – este dominio/registro no admite la transferencia de contactos
• 3229 – el contacto no está disponible
• 3237 – el contacto ya está registrado con nosotros
• 3240 – error de autorización
• 3241 – la transferencia ha fallado
• 4216 – la transferencia ha fallado – error de conexión

Datos de la respuesta: Ninguno – el resultado lo transmiten directamente los campos code/msg.

Ejemplo:

curl -X POST -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' \
  'https://api.wedos.com/v2/contacts/CONTACT/transfer' \
  --data '{"tld": "cz", "auth_info": "AUTHCODE123"}'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "a1b2c3f4"
}

POST /contacts/{cname}/auth-info/send

Envía el código de autorización del contacto a su correo electrónico de contacto.

Parámetros:

• cname – obligatorio, path – handle del contacto
• tld – obligatorio, string – TLD
• reg_key – opcional, string – identificador de un registro concreto

Códigos de retorno:

• 1000 – OK
• 2100 – falta un parámetro obligatorio
• 2101 – parámetros de entrada no válidos
• 2201 – TLD no válido
• 2216 – nombre de contacto no válido
• 2243 – el envío del código de autorización no está permitido para este contacto
• 3213 – el contacto no está disponible
• 3215 – el envío del código ha fallado
• 3228 – el registro no admite contactos
• 4217 – el envío ha fallado – error de comunicación
• 5001 – error de autenticación

Datos de la respuesta: Ninguno – el resultado lo transmiten directamente los campos code/msg.

Ejemplo:

curl -X POST -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' \
  'https://api.wedos.com/v2/contacts/CONTACT/auth-info/send' \
  --data '{"tld": "eu"}'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "a1b2c3f5"
}

PATCH /contacts/{cname}

Modifica los datos de un contacto existente. No se puede usar en los registros en los que los contactos no son editables (p. ej. Ascio).

Parámetros:

• cname – obligatorio, path – handle del contacto
• tld – obligatorio, string – TLD
• auth_info – opcional, string – el código de autorización del contacto
• contact – obligatorio, object – datos del contacto que se van a modificar (los mismos campos que en POST /contacts/create; solo se cambian los campos indicados)
• reg_key – opcional, string – identificador de un registro concreto

Códigos de retorno:

• 1000 – OK
• 2100 – falta un parámetro obligatorio
• 2101 – parámetros de entrada no válidos
• 2201 – TLD no válido
• 2207 – error de sintaxis
• 2216 – nombre de contacto no válido
• 2219–2241 – faltan elementos modificados concretos o su formato no es válido (el mismo conjunto que en la creación del contacto)
• 3211 – no se ha podido cargar el contacto
• 3238 – error de autorización
• 3239 – la modificación ha fallado
• 4202 – contacto no disponible – error de conexión
• 4215 – la ejecución ha fallado – error de conexión

Datos de la respuesta: Ninguno – el resultado lo transmiten directamente los campos code/msg.

Ejemplo:

curl -X PATCH -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' \
  'https://api.wedos.com/v2/contacts/CONTACT' \
  --data '{"tld": "eu", "contact": {"email": "esmeralda-new@wedos.com"}}'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "a1b2c3f6"
}