WAPI – Contactos de dominio

En este artículo encontrará información sobre la gestión de los contactos de dominio con los siguientes TLD admitidos:

• CZ
• EU
• SK
• PL
• gTLD y nTLD

y también en los siguientes comandos:

• contact-check – comprobar la disponibilidad del contacto
• contact-info – listar la información del contacto
• contact-create – crear un nuevo contacto
• contact-update – editar los datos del contacto
• contact-transfer – transferir contacto de otro registrador
• contact-send-auth-info – enviar el AUTH-ID del contacto

---

Contactos del dominio por registros individuales

Cada registro de dominios gestiona los contactos de forma distinta; existen reglas diferentes para los identificadores de contacto, los elementos obligatorios de los datos, etc.

Dominios CZ

Al crear un contacto para un dominio CZ, puede especificar un nombre. Use el contact-check para comprobar si el nombre elegido está disponible (no usado, bloqueado, ..).

El nombre de contacto solo puede contener letras mayúsculas del alfabeto inglés, números y un guion. Si no indica un nombre al crear el contacto, el sistema lo generará automáticamente.

En el detalle del contacto puede configurar:

• cname – nombre del contacto (solo al crear uno nuevo); omita este parámetro o déjelo en blanco para generar un nombre pseudoaleatorio)
• company
• fname – nombre – obligatorio
• lname – apellido – obligatorio
• correo electrónico – obligatorio
• phone – número de teléfono +XXX XXXXXXXXX
• fax – número de fax +XXX XXXXXXXXX
• dic – NIF/VAT ID
• addr_street – calle y número – obligatorio
• addr_city – dirección de la ciudad – obligatorio
• addr_zip – código postal – obligatorio
• addr_country – país (código ISO de dos letras, en minúsculas) – obligatorio
• addr_state – estado o región
• ident_type – tipo de documento de identidad (ico (ID de empresa), op (documento personal), birthday (fecha de nacimiento en formato DD.MM.YYYY), passport, mpsv (ID del MPSV))
• ident – número del documento de identidad (según ident_type)
• notify_email – dirección de correo para notificaciones
• disclose_phone – ocultar el teléfono
• disclose_fax – ocultar el fax
• disclose_email – ocultar el correo
• disclose_ident – ocultar el número del documento de identidad
• disclose_notify_email – ocultar el correo de notificaciones

En los contactos de dominios CZ es posible ocultar algunos elementos de los datos de contacto. Utilice el disclose_* entradas en el detalle del contacto con un indicador 0/1 (1 = oculto, 0 = público) para especificar si esa información debe ocultarse. Si la información está marcada como oculta, no se puede consultar sin autorización.

Desde mediados de enero de 2018 puede configurar un dirección de entrega para contactos de dominios CZ. Al crear o editar un contacto, indique los siguientes elementos:

• del_addr=1 – dirección de entrega activa (obligatorio)
• del_addr_street1 – calle (obligatorio)
• del_addr_street2 – calle (opcional)
• del_addr_street3 – calle (opcional)
• del_addr_city – ciudad (obligatorio)
• del_addr_state – estado o región
• del_addr_country – país (código ISO de dos letras, en minúsculas) (obligatorio)

Para desactivar la dirección de entrega de un contacto, introduzca del_addr=0 al crear o editar un contacto.

Dominios EU

Al crear un contacto en el registro EURid, no puede especificar su name. El sistema siempre lo asigna automáticamente.

En el detalle del contacto puede configurar:

• company
• fname – nombre – obligatorio
• lname – apellido – obligatorio
• correo electrónico – obligatorio
• phone – número de teléfono +XXX XXXXXXXXX
• fax – número de fax +XXX XXXXXXXXX
• dic – NIF/VAT ID
• addr_street – calle y número – obligatorio
• addr_city – dirección de la ciudad – obligatorio
• addr_zip – código postal – obligatorio
• addr_country – país (código ISO de dos letras, en minúsculas) – obligatorio
• addr_state – estado o región

Dominios SK

Al crear un contacto para un dominio SK, puede especificar un nombre. Use el contact-check para comprobar si el nombre elegido está disponible (no usado, bloqueado, ..).

El nombre de contacto solo puede contener letras mayúsculas del alfabeto inglés, números, guiones y puntos. La longitud mínima del nombre de contacto es de 5 caracteres y la máxima de 16. Si no indica un nombre al crear el contacto, el sistema lo generará automáticamente. El formato del nombre de contacto generado automáticamente es WEDOS-XXX-YYYY (donde XXX es una combinación de letras y números e YYYY son solo dígitos).

En el detalle del contacto puede configurar:

• cname – nombre del contacto (solo al crear uno nuevo); omita este parámetro o déjelo en blanco para generar un nombre pseudoaleatorio)
• company
• fname – nombre – obligatorio
• lname – apellido – obligatorio
• correo electrónico – obligatorio
• phone – número de teléfono +XXX XXXXXXXXX
• fax – número de fax +XXX XXXXXXXXX
• dic – NIF/VAT ID
• addr_street – calle y número – obligatorio
• addr_city – dirección de la ciudad – obligatorio
• addr_zip – código postal – obligatorio
• addr_country – país (código ISO de dos letras, en minúsculas) – obligatorio
• addr_state – estado o región
• ident_type – tipo de sujeto, solo se puede establecer una vez (PERS = persona física, CORP = empresa)
• ident – valor de identificación (PERS = fecha de nacimiento en formato RRRR-MM-DD, CORP = ID de empresa)
• disclose_name – ocultar el nombre
• disclose_org – ocultar el nombre de la empresa
• disclose_addr – ocultar la dirección
• disclose_phone – ocultar el teléfono
• disclose_fax – ocultar el fax
• disclose_email – ocultar la dirección de correo

Dominios PL

Al crear un contacto PL, no puede especificar su name. El sistema siempre lo asigna automáticamente.

En el detalle del contacto puede configurar:

• company
• fname – nombre, no se puede cambiar para legal_type = individual – obligatorio
• lname – apellido, no se puede cambiar para legal_type = individual – obligatorio
• correo electrónico – obligatorio
• phone – número de teléfono +XXX XXXXXXXXX
• fax – número de fax +XXX XXXXXXXXX
• dic – NIF/VAT ID
• addr_street – calle y número – obligatorio
• addr_city – dirección de la ciudad – obligatorio
• addr_zip – código postal – obligatorio
• addr_country – país (código ISO de dos letras, en minúsculas) – obligatorio
• addr_state – estado o región
• legal_type – tipo legal (company, individual), no se puede cambiar – obligatorio

Dominios gTLD y nTLD

Al crear un contacto para dominios gTLD y nTLD, no puede especificar su nombre; el sistema lo crea automáticamente.

En el detalle del contacto puede configurar:

• company
• fname – nombre – obligatorio
• lname – apellido – obligatorio
• correo electrónico – obligatorio
• phone – número de teléfono +XXX XXXXXXXXX
• fax – número de fax +XXX XXXXXXXXX
• dic – NIF/VAT ID
• addr_street – calle y número – obligatorio
• addr_city – dirección de la ciudad – obligatorio
• addr_zip – código postal – obligatorio
• addr_country – país (código ISO de dos letras, en minúsculas) – obligatorio
• addr_state – estado o región

---

contact-check

Utilice el contact-check solicitud para verificar la disponibilidad de un nombre de contacto.

Parámetros

• tld – TLD para el que se crea el contacto (p. ej. eu)
• cname – nombre del contacto

Valores devueltos

• 1000 – el contacto está libre y se puede usar
• 2201 – TLD no válido
• 2216 – formato de contacto no válido
• 2218 – el nombre se genera automáticamente (para algunos TLD no se puede especificar un nombre de contacto)
• 3231 – el contacto ya existe
• 3233 – el contacto no se puede usar
• 3234 – el contacto no se puede usar – en cuarentena
• 3235 – el contacto no se puede usar – reservado
• 3236 – el contacto no se puede usar – bloqueado
• 4211 – fallo en la verificación – error de comunicación, repita el comando más tarde

Datos de respuesta

La petición no devuelve datos.

Plantillas

Requerimiento JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-check",
    "clTRID": "your ID",
    "data": {
      "tld": "tld",
      "cname": "contact id"
    }
  }
}

Respuesta JSON (OK):

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

---

contact-info

El contact-info devuelve información detallada sobre un contacto.

Parámetros

• tld – TLD – obligatorio
• cname – nombre del contacto – obligatorio
• auth_info – AUTH-ID del contacto – opcional (si el dominio lo admite, al introducir el AUTH-ID se mostrarán los datos ocultos del contacto)
• reg_key – ID del registro – opcional

Valores devueltos

• 1000 – información del contacto recibida correctamente
• 2201 – TLD no válido
• 2216 – sintaxis de contacto no válida 
• 3215 – ha fallado el envío de auth info del contacto
• 3228 – valor no compatible
• 3229 – error al cargar el contacto
• 3236 – contacto bloqueado
• 4212 – error de conexión
• 5001 – sin sesión iniciada

Datos de respuesta

Si se realiza correctamente (código 1000), el comando devuelve información sobre el contacto en el nodo contact.

Plantillas

Requerimiento JSON (contacto CZ.NIC):

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-info",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "cname": "contact-id",
      "auth_info": "auth-info-string",
      "reg_key": "cznic",
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "contact-info",
    "data": {
      "contact": {
        "contact_id": "contact id",
        "status": "status",
        "name": "name and surname",
        "company": "company",
        "addr_street": "street and number",
        "addr_city": "city",
        "addr_zip": "zip code",
        "addr_state": "state or region",
        "addr_country": "country iso code",
        "phone": "full phone number",
        "email": "email",
        "fax": "full fax number",
        "reg_owner": "",
        "reg_creator": "",
        "reg_update": "",
        "created_date": "YYYY-MM-DD hh:mm:ss",
        "updated_date": "YYYY-MM-DD hh:mm:ss",
        "transfer_date": "YYYY-MM-DD hh:mm:ss",
        "fname": "name",
        "lname": "surname",
        "email2": "",
        "ic": "company id",
        "dic": "vat id",
        "taxpayer": "",
        "disclose": "",
        "other": {
          "notify_email": "",
          "ident_type": "",
          "ident": ""
        }
      }
    }
  }
}

Respuesta JSON (contacto no encontrado):

{
  "response":
  {
    "code":3215,
    "result":"Contact send auth info failed",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command":"contact-info"
  }
}

---

contact-create

Utilice el contact-create solicitud para crear un nuevo contacto que pueda usar con sus dominios registrados en el registro correspondiente. Cada contacto se identifica por su nombre, que siempre es único. Puede encontrar más información sobre el trabajo con contactos en los distintos registros en el capítulo Contactos del dominio por registros individuales.

Parámetros

• tld – TLD del dominio
• contacto – matriz de elementos de contacto:
  • cname – nombre del contacto (vacío = generar automáticamente)
  • fname – nombre
  • lname – apellido
  • company – empresa
  • addr_street – calle y número
  • addr_city – ciudad
  • addr_zip – código postal
  • addr_state – estado o región
  • addr_country – país (código ISO de dos letras, en minúsculas)
  • phone
  • fax
  • correo electrónico
  • otros elementos según el registro

Valores devueltos

• 1000 = el contacto se ha creado correctamente
• 2201 = tld no válido
• 2216 = nombre de contacto no válido
• 2218 = el nombre del contacto se crea automáticamente
• 2219 = elemento empresa sin rellenar
• 2220 = el nombre del elemento no está relleno
• 2221 = apellido sin rellenar 
• 2222 = email sin rellenar 
• 2223 = formato incorrecto del email
• 2224 = email2 sin rellenar
• 2225 = formato incorrecto de email2
• 2226 = teléfono sin rellenar
• 2227 = formato incorrecto del teléfono
• 2228 = fax sin rellenar
• 2229 = formato incorrecto del fax 
• 2230 = ID de empresa sin rellenar 
• 2231 = formato incorrecto del ID de empresa
• 2232 = Número de IVA sin rellenar
• 2233 = Formato incorrecto del número de IVA
• 2234 = calle sin rellenar
• 2235 = ciudad sin rellenar
• 2236 = Código postal sin rellenar
• 2237 = país sin rellenar
• 2238 = formato incorrecto del país
• 2239 = provincia sin rellenar
• 2240 = otros datos sin rellenar
• 2241 = formato incorrecto de otros datos 
• 3228 = el dominio no trabaja con contactos
• 3230 = no se ha podido crear un contacto
• 3231 = el nombre del contacto ya está en uso
• 3232 = el contacto no se puede usar – motivo desconocido
• 3233 = el contacto no se puede usar
• 3234 = el contacto no se puede usar – en 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 = no se ha podido comprobar el contacto – error de comunicación
• 4213 = no se ha podido crear un contacto – error de comunicación

Datos de respuesta

El contacto devuelve los siguientes datos:

• cname – nombre del contacto creado

Plantillas

Requerimiento JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-create",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "contact": {
        "fname": "name",
        "lname": "surname",
        "email": "email",
        "addr_street": "street and number",
        "addr_city": "city",
        "addr_zip": "zip code",
        "addr_country": "country ISO code",
        "phone": "full phone number",
        "notify_email": "notification email"
      }
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "contact-create",
    "data": {
      "cname": "contact id"
    }
  }
}

---

contact-update

Utilice el contact-update solicitud para editar los datos de un contacto.

Encontrará más información sobre el trabajo con contactos en los distintos registros en el capítulo Contactos del dominio por registros individuales.

Parámetros

• tld – TLD
• cname – nombre del contacto
• auth_info – AUTH-ID
• contacto – elementos del contacto
  • fname – nombre
  • lname – apellido
  • company
  • addr_street – calle y número
  • addr_city – ciudad
  • addr_zip – código postal
  • addr_state – estado o región
  • addr_country – país (código ISO de dos letras, en minúsculas)
  • phone
  • fax
  • correo electrónico
  • otros elementos según el registro

Valores devueltos

• 1000 = OK
• 2201 = TLD no válido
• 2207 = sintaxis no válida en el nombre del contacto
• 2216 = nombre de contacto no válido
• 2219 = elemento empresa sin rellenar
• 2220 = elemento nombre sin rellenar
• 2221 = elemento apellido sin rellenar
• 2222 = elemento email sin rellenar
• 2223 = formato incorrecto del elemento email
• 2224 = elemento email2 sin rellenar
• 2225 = formato incorrecto del elemento email2
• 2226 = elemento teléfono sin rellenar
• 2227 = formato incorrecto del elemento teléfono
• 2228 = elemento fax sin rellenar
• 2229 = formato incorrecto del elemento fax
• 2230 = elemento ID de empresa sin rellenar
• 2231 = formato incorrecto del elemento ID de empresa
• 2232 = elemento número de IVA sin rellenar
• 2233 = formato incorrecto del elemento número de IVA
• 2234 = elemento calle sin rellenar
• 2235 = elemento ciudad sin rellenar
• 2236 = elemento código postal sin rellenar
• 2237 = elemento país sin rellenar
• 2238 = formato incorrecto del elemento país
• 2239 = elemento provincia sin rellenar
• 2240 = elemento otros datos sin rellenar
• 2241 = formato incorrecto del elemento otros datos
• 3211 = error – no se ha podido obtener el contacto
• 3238 = error de autorización
• 3239 = la operación ha fallado
• 4202 = contacto no disponible – error de conexión, inténtelo más tarde
• 4215 = la implementación ha fallado – error de conexión, inténtelo más tarde

Datos de respuesta

La petición no devuelve datos.

Plantillas

Comando JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-update",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "contact": {
        "fname": "name",
        "lname": "surname",
        "email": "email",
        "addr_street": "street and number",
        "addr_city": "city",
        "addr_zip": "zip code",
        "addr_country": "country ISO code",
        "phone": "full phone number",
        "notify_email": "email"
      }
    }
  }
}

Respuesta JSON (OK):

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

contact-transfer

Utilice el contact-transfer solicitud para transferir un contacto de otro registrador a WEDOS.

Parámetros

• tld – TLD
• cname – nombre del contacto
• auth_info – AUTH-ID

Valores devueltos

• 1000 = OK
• 2201 = TLD no válido
• 2215 = falta el parámetro auth_info
• 2216 = identificador de contacto no válido  
• 2244 = Este dominio 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 = no se ha podido transferir
• 4216 = ha fallado – error de conexión

Datos de respuesta

La petición no devuelve datos.

Plantillas

Requerimiento JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-transfer",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "cname": "contact id",
      "auth_info": "auth-id"
    }
  }
}

Respuesta JSON (OK):

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

---

contact-send-auth-info

Utilice el contact-send-auth-info solicitud para enviar un correo con el AUTH-ID del contacto.

Parámetros

• tld – TLD
• cname – nombre del contacto

Valores devueltos

• 1000 = OK
• 2201 = TLD no válido
• 2216 = nombre de contacto no válido
• 2243 = no está permitido enviar auth_info
• 3213 = el contacto no está disponible
• 3215 = no se ha podido enviar el auth-id
• 3228 = el contacto no es compatible con este dominio
• 4217 = el envío ha fallado – error de comunicación

Datos de respuesta

La petición no devuelve datos.

Plantillas

Requerimiento JSON:

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

Respuesta JSON (OK):

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