Cómo crear un contacto y prepararlo con la API

Cada nombre de dominio tiene un titular: la persona o empresa a la que pertenece. En tu cuenta, el titular es uno de tus contactos. Con la API de Site.es, puedes crear ese contacto desde tu propio script.

Algunas extensiones también piden datos adicionales del titular. Para .es, por ejemplo, un número de identificación. En cuanto el contacto tiene esos datos, está preparado para esa extensión. Entonces puedes registrar nombres de dominio con él al instante.

¿Prefieres hacerlo en tu panel de control? Lee cómo preparar un contacto para una extensión de dominio. ¿Es la primera vez que usas nuestra API? Entonces lee primero cómo empezar a usar la API.

Qué necesitas

Una clave API. Créala en tu panel de control, en Ajustes, en la pestaña Claves API. En Endpoints de API, marca:

• contacts.create: crear contactos.
• contacts.required_info: comprobar y añadir los datos adicionales para una extensión.
• contacts.view: ver tus contactos y las extensiones para las que están preparados.

Pon tu clave API en la cabecera X-API-Key de cada solicitud. Envía los campos en formato JSON en el cuerpo.

Paso 1: crea el contacto

POST https://backend.site.es/v2/contacts

Envía estos campos:

• first_name y last_name (obligatorios).
• email (obligatorio).
• phone_number (obligatorio): solo cifras, sin + ni 00. Envía el número nacional, o el prefijo del país seguido del número, como 31201234567 para un número neerlandés.
• address (obligatorio): con address_line_first, city, postal_code y country_id. Omite postal_code solo si el país no tiene códigos postales.
• company_name: solo si el titular de los nombres de dominio es una empresa.
• vat_number: opcional. Para los países de la UE, lo comprobamos en la base de datos VIES de la UE.

Encuentras el country_id con GET /v2/countries. Esa llamada no necesita clave API.

La respuesta es el contacto nuevo, con su id. Necesitas ese ID en los pasos siguientes. ¿Algo no está bien? Entonces recibes INPUT_001, con el campo y el problema en fields. Por ejemplo, un número de teléfono que no corresponde al país.

Paso 2: comprueba qué necesita la extensión

GET https://backend.site.es/v2/tlds/required_info?contact_id=3101&tld=.es

Aquí, 3101 es el ID de tu contacto y .es es la extensión. Comprobamos el contacto con el registro de la extensión. Después recibes una de estas dos respuestas:

• Una lista vacía: el contacto está preparado para esta extensión. No tienes que hacer nada más.
• Una lista con required_info: los datos que el registro todavía necesita. Cada campo tiene su nombre, y mandatory indica si tienes que rellenarlo. Algunos campos también muestran los valores entre los que puedes elegir (values) o el formato (regex). También puede aparecer un mensaje del registro.

Los nombres de los campos empiezan por el nombre del registro, como Esnic.identificationNumber para .es. Necesitas ese nombre del registro en el siguiente paso: es la parte que va antes del punto.

Paso 3: añade los datos

PATCH https://backend.site.es/v2/contacts/3101/required_info

Envía estos campos:

• registry: el nombre del registro, como Esnic.
• tld: la extensión, como .es.
• properties: cada campo del paso 2 con su valor. Usa los nombres de campo completos, como Esnic.identificationNumber.

Comprobamos los datos con el registro. ¿Los acepta? Entonces los guardamos y el contacto queda preparado. ¿Los rechaza? Entonces no se guarda nada y recibes INPUT_002 con los campos que hay que corregir.

Algunas extensiones necesitan a una persona física como contacto para algunos roles, aunque el titular del nombre de dominio sea una empresa. En ese caso, la respuesta del paso 2 incluye contact_roles con person. Envía person junto con los datos: "contact_person" usa la persona de contacto de la empresa; si no, envía el ID de uno de tus contactos que sea una persona física.

Paso 4: comprueba que el contacto está preparado

Repite el paso 2. ¿La lista está vacía? Entonces el contacto está preparado. También puedes verlo con GET /v2/contacts: ready_tlds enumera todas las extensiones para las que está preparado el contacto.

Ahora puedes registrar un nombre de dominio con este contacto como titular. Envía su ID como contact_id. Lee cómo pedir nombres de dominio con la API.

Conviene saberlo

• También puedes enviar los datos con un pedido. Registra o transfiere un nombre de dominio y añade los datos como required_info. Los comprobamos y los guardamos en el contacto.
• ¿El contacto no sirve para la extensión? Algunas extensiones solo aceptan una empresa, o solo una persona física. Entonces recibes REG_006. Usa otro contacto.
• ¿Has recibido REG_005? Entonces el contacto ya tiene todos los datos para esta extensión.
• No todas las extensiones necesitan datos adicionales. Para .com, por ejemplo, la comprobación del paso 2 suele dar una lista vacía al instante.

¿Necesitas ayuda? Contacta con nosotros por WhatsApp, Telegram o correo electrónico.