WAPI - Contactos de dominio

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

• CZ
• UE
• SK
• PL
• gTLD a nTLD

y también en los siguientes comandos:

• contact-check - comprobar la disponibilidad de los contactos
• contact-info - lista de información de contacto
• contact-create - crear nuevo contacto
• contact-update - editar datos de contacto
• contact-transfer - transferir contacto desde otro registrador
• contact-send-auth-info - enviar AUTH-ID de contacto

---

Contactos de dominios por registros individuales

Cada registro de dominios gestiona los contactos de forma diferente, existen normas distintas para los identificadores de contacto, los elementos obligatorios en los detalles, etc.

CZ Dominios

Al crear un contacto para un dominio CZ, puede especificar un nombre. Utilice la comprobación de contactos para comprobar si el nombre elegido está disponible (no utilizado, bloqueado, ..).

El nombre del contacto sólo puede contener letras mayúsculas del alfabeto inglés, números y un guión. Si no especifica un nombre al crear un contacto, el sistema generará uno automáticamente.

En los detalles del contacto, puedes configurar:

• cname - nombre del contacto (sólo al crear uno nuevo); omita este parámetro o déjelo en blanco para generar un nombre pseudoaleatorio)
• empresa
• fname - nombre - obligatorio
• lname - apellido - obligatorio
• correo electrónico - obligatorio
• teléfono - número de teléfono +XXX XXXXXXXXX
• fax - número de fax +XXX XXXXXXXXX
• dic - CIF
• addr_street - dirección y número de casa - 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 (identificación de empresa), op (identificación personal), cumpleaños (fecha de nacimiento en formato DD.MM.AAAA), pasaporte, mpsv (identificación MPSV))
• ident - Número de documento de identidad (según ident_type)
• notify_email - dirección de correo electrónico de notificación
• disclose_phone - ocultar teléfono
• disclose_fax - ocultar fax
• disclose_email - ocultar correo electrónico
• disclose_ident - ocultar el número de documento de identidad
• disclose_notify_email - ocultar el correo electrónico de notificación

Para los contactos del dominio CZ, es posible ocultar algunos elementos en los detalles del contacto. Utilice las entradas disclose_* en los detalles del contacto con una bandera 0/1 (1 = oculto, 0 = público) para especificar si esa información debe estar oculta. Si esta información se marca como oculta, no se podrá ver sin autorización.

Desde mediados de enero de 2018, puede establecer una dirección de entrega para los contactos del dominio CZ. Al crear/editar un contacto, introduzca los siguientes elementos:

• del_addr=1 - dirección de entrega acive (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/editar un contacto.

EU Dominios

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

En los detalles del contacto, puedes configurar:

• empresa
• fname - nombre - obligatorio
• lname - apellido - obligatorio
• correo electrónico - obligatorio
• teléfono - número de teléfono +XXX XXXXXXXXX
• fax - número de fax +XXX XXXXXXXXX
• dic - CIF
• addr_street - dirección y número de casa - 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

SK Dominios

Al crear un contacto para un dominio SK, puede especificar un nombre. Utilice la comprobación de contactos para comprobar si el nombre elegido está disponible (no utilizado, bloqueado, ..).

El nombre del contacto sólo puede contener letras mayúsculas del alfabeto inglés, números, guiones y puntos. La longitud mínima del nombre del contacto es de 5 caracteres, la longitud máxima es de 16 caracteres. Si no especifica un nombre al crear un 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 sólo dígitos).

En los detalles del contacto, puedes configurar:

• cname - nombre del contacto (sólo al crear uno nuevo); omita este parámetro o déjelo en blanco para generar un nombre pseudoaleatorio)
• empresa
• fname - nombre - obligatorio
• lname - apellido - obligatorio
• correo electrónico - obligatorio
• teléfono - número de teléfono +XXX XXXXXXXXX
• fax - número de fax +XXX XXXXXXXXX
• dic - CIF
• addr_street - dirección y número de casa - 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, sólo puede establecerse una vez(PERS = persona física, CORP = empresa)
• ident - valor de identificación(PERS = fecha de nacimiento en formato RRRR-MM-DD, CORP = identificación de la empresa)
• disclose_name - ocultar nombre
• disclose_org - ocultar el nombre de la empresa
• disclose_addr - ocultar dirección de destino
• disclose_phone - ocultar teléfono
• disclose_fax - ocultar fax
• disclose_email - ocultar dirección de correo electrónico

Dominios PL

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

En los detalles del contacto, puedes configurar:

• empresa
• fname - nombre, no puede cambiarse para legal_type = individual - obligatorio
• lname - apellido, no puede cambiarse para legal_type = individual - obligatorio
• correo electrónico - obligatorio
• teléfono - número de teléfono +XXX XXXXXXXXX
• fax - número de fax +XXX XXXXXXXXX
• dic - CIF
• addr_street - dirección y número de casa - 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 (empresa, persona física), no modificable - 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 los detalles del contacto, puedes configurar:

• empresa
• fname - nombre - obligatorio
• lname - apellido - obligatorio
• correo electrónico - obligatorio
• teléfono - número de teléfono +XXX XXXXXXXXX
• fax - número de fax +XXX XXXXXXXXX
• dic - CIF
• addr_street - dirección y número de casa - 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

---

contacto-comprobar

Utilice la solicitud de comprobación de contacto para verificar la disponibilidad de un nombre de contacto.

Parámetros

• tld - TLD para el que se crea el contacto (por ejemplo, eu)
• cname - nombre del contacto

Valores de retorno

• 1000 - el contacto es gratuito y puede utilizarse
• 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 - no se puede utilizar el contacto
• 3234 - no se puede utilizar el contacto - en cuarentena
• 3235 - contacto no utilizable - reservado
• 3236 - contacto no utilizable - bloqueado
• 4211 - verificación fallida - error de comunicación, repita el comando 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": "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"
  }
}

---

información de contacto

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

Parámetros

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

Valores de retorno

• 1000 - contacto Información recibida correctamente
• 2201 - TLD no válido
• 2216 - sintaxis de contacto no válida 
• 3228 - valor no admitido
• 3229 - error al cargar el contacto
• 4212 - error de conexión

Datos de respuesta

Si tiene éxito (código 1000), el comando devuelve información sobre el contacto en el nodo de contacto.

Plantillas

Solicitud JSON:

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

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": ""
        }
      }
    }
  }
}

---

contacto-crear

Utilice la solicitud contact-create para crear un nuevo contacto que podrá utilizar 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 cómo trabajar con contactos con registros individuales en el capítulo Contactos de dominio por registros individuales.

Parámetros

• tld - dominio TLD
• póngase en contacto con - matriz de elementos de contacto:
  • cname - nombre del contacto (vacío = se genera automáticamente)
  • fname - nombre
  • lname - apellido
  • empresa - empresa
  • addr_street - calle y número de casa
  • 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)
  • teléfono
  • fax
  • correo electrónico
  • otros elementos en función del registro

Valores de retorno

• 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 = empresa del artículo no cumplimentado
• 2220 = el nombre del artículo no está completo
• 2221 = apellido no rellenado 
• 2222 = email no rellenado 
• 2223 = email formato incorrecto
• 2224 = email2 no rellenado
• 2225 = email2 formato incorrecto
• 2226 = teléfono no ocupado
• 2227 = teléfono formato incorrecto
• 2228 = fax sin rellenar
• 2229 = fax formato incorrecto 
• 2230 = ID de empresa no rellenado 
• 2231 = ID de empresa formato incorrecto
• 2232 = Número de IVA no cumplimentado
• 2233 = Número de IVA formato incorrecto
• 2234 = calle sin rellenar
• 2235 = ciudad no ocupada
• 2236 = ZIP no rellenado
• 2237 = país no cumplimentado
• 2238 = país formato incorrecto
• 2239 = estado sin rellenar
• 2240 = otros datos no cumplimentados
• 2241 = otros datos formato incorrecto 
• 3228 = el dominio no funciona con los contactos
• 3230 = no se ha podido crear un contacto
• 3231 = nombre de contacto ya utilizado
• 3232 = no se puede utilizar el contacto - motivo desconocido
• 3233 = no se puede utilizar el contacto
• 3234 = contacto no utilizable - en cuarentena
• 3235 = contacto no utilizable - reservado
• 3236 = contacto no utilizable - 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

Solicitud 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"
    }
  }
}

---

contacto-actualización

Utilice la solicitud de actualización de contacto para editar las entradas de contacto.

Puede encontrar más información sobre cómo trabajar con contactos con registros individuales en el capítulo Contactos de dominio por registros individuales.

Parámetros

• tld - TLD
• cname - nombre del contacto
• auth_info - AUTH-ID
• póngase en contacto con - elementos de contacto
  • fname - nombre
  • lname - apellido
  • 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)
  • teléfono
  • fax
  • correo electrónico
  • otros artículos según registro

Valores de retorno

• 1000 = OK
• 2201 = TLD no válido
• 2207 = sintaxis inválida en el nombre del contacto
• 2216 = nombre de contacto no válido
• 2219 = empresa del artículo no cumplimentado
• 2220 = nombre del artículo no rellenado
• 2221 = apellido no rellenado
• 2222 = correo electrónico no rellenado
• 2223 = correo electrónico con formato de artículo incorrecto
• 2224 = elemento no rellenado email2
• 2225 = formato de artículo incorrecto email2
• 2226 = teléfono de artículo no rellenado
• 2227 = teléfono con formato de artículo incorrecto
• 2228 = fax de artículo no rellenado
• 2229 = fax con formato de artículo incorrecto
• 2230 = identificación de la empresa no cumplimentada
• 2231 = ID de empresa con formato de artículo incorrecto
• 2232 = partida no cumplimentada Número de IVA
• 2233 = número de IVA con formato de artículo incorrecto
• 2234 = calle del artículo no rellenada
• 2235 = ciudad no cumplimentada
• 2236 = código postal no rellenado
• 2237 = país no cumplimentado
• 2238 = país con formato de artículo incorrecto
• 2239 = estado del artículo sin rellenar
• 2240 = elemento no rellenado otros datos
• 2241 = formato incorrecto del artículo en la fecha indicada
• 3211 = error - no se ha podido recuperar el contacto
• 3238 = error de autorización
• 3239 = operación fallida
• 4202 = contacto no disponible - error de conexión, inténtelo más tarde
• 4215 = fallo en la implementación - error de conexión, inténtelo de nuevo más tarde

Datos de respuesta

La solicitud no devuelve ningún dato.

Plantillas

JSON příkaz:

{
  "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",
  }
}

contacto-transferencia

Utilice la solicitud de transferencia de contacto para transferir un contacto de otro registrador a WEDOS.

Parámetros

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

Valores de retorno

• 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 = contacto no disponible
• 3237 = el contacto ya está registrado con nosotros
• 3240 = error de autorización
• 3241 = transferencia fallida
• 4216 = fallido - error de conexión

Datos de respuesta

La solicitud no devuelve ningún dato.

Plantillas

Solicitud 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 la solicitud contact-send-auth-info para enviar un correo electrónico con el AUTH-ID del contacto.

Parámetros

• tld - TLD
• cname - nombre del contacto

Valores de retorno

• 1000 = OK
• 2201 = TLD no válido
• 2216 = nombre de contacto no válido
• 2243 = no se permite enviar auth_info
• 3213 = contacto no disponible
• 3215 = fallo al enviar auth-id
• 3228 = el contacto no es compatible con este dominio
• 4217 = envío fallido - error de comunicación

Datos de respuesta

La solicitud no devuelve ningún dato.

Plantillas

Solicitud 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",
  }
}