Comment créer un contact et le préparer avec l'API

Chaque nom de domaine a un titulaire : la personne ou l'entreprise à qui il appartient. Dans ton compte, le titulaire est l'un de tes contacts. Avec l'API Site.fr, tu peux créer ce contact depuis ton propre script.

Certaines extensions demandent aussi des informations supplémentaires sur le titulaire. Pour le .es, par exemple, c'est un numéro d'identification. Une fois que le contact a ces informations, il est prêt pour cette extension. Tu peux alors enregistrer tout de suite des noms de domaine avec lui.

Tu préfères le faire dans ton tableau de bord ? Découvre comment préparer un contact pour une extension de domaine. Tu débutes avec notre API ? Lis d'abord comment démarrer avec l'API.

Ce dont tu as besoin

Une clé API. Crée-en une dans ton tableau de bord sous Paramètres, dans l'onglet Clés API. Sous Points de terminaison API, coche :

• contacts.create : créer des contacts.
• contacts.required_info : vérifier et ajouter les informations supplémentaires pour une extension.
• contacts.view : voir tes contacts et les extensions pour lesquelles ils sont prêts.

Mets ta clé API dans l'en-tête X-API-Key de chaque requête. Envoie les champs en JSON dans le corps de la requête.

Étape 1 : créer le contact

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

Envoie ces champs :

• first_name et last_name (obligatoires).
• email (obligatoire).
• phone_number (obligatoire) : uniquement des chiffres, sans + ni 00. Envoie le numéro national, ou l'indicatif du pays suivi de ce numéro, comme 31201234567 pour un numéro néerlandais.
• address (obligatoire) : avec address_line_first, city, postal_code et country_id. N'omets postal_code que si le pays n'a pas de codes postaux.
• company_name : uniquement si c'est une entreprise qui est titulaire des noms de domaine.
• vat_number : facultatif. Pour les pays de l'UE, nous le vérifions dans la base de données VIES de l'UE.

Tu trouves le country_id avec GET /v2/countries. Cet appel ne demande pas de clé API.

La réponse contient le nouveau contact, avec son id. Tu as besoin de cet ID pour les étapes suivantes. Quelque chose ne va pas ? Tu reçois alors INPUT_001, avec le champ et le problème sous fields. Par exemple, un numéro de téléphone qui ne correspond pas au pays.

Étape 2 : vérifier ce dont l'extension a besoin

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

Ici, 3101 est l'ID de ton contact et .es est l'extension. Nous vérifions le contact auprès du registre. Tu reçois ensuite l'une de ces deux réponses :

• Une liste vide : le contact est prêt pour cette extension. Tu n'as rien d'autre à faire.
• Une liste avec required_info : les informations dont le registre a encore besoin. Chaque champ a son nom, et mandatory indique si tu dois le remplir. Certains champs indiquent aussi les valeurs possibles (values) ou le format (regex). Un message du registre peut aussi y figurer.

Les noms des champs commencent par le nom du registre, comme Esnic.identificationNumber pour le .es. Tu as besoin de ce nom de registre à l'étape suivante : c'est la partie avant le point.

Étape 3 : ajouter les informations

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

Envoie ces champs :

• registry : le nom du registre, comme Esnic.
• tld : l'extension, comme .es.
• properties : chaque champ de l'étape 2 avec sa valeur. Utilise les noms de champs complets, comme Esnic.identificationNumber.

Nous vérifions les informations auprès du registre. Il les accepte ? Nous les enregistrons alors, et le contact est prêt. Il les refuse ? Rien n'est enregistré, et tu reçois INPUT_002 avec les champs à corriger.

Pour certains rôles, quelques extensions exigent une personne physique comme contact, même quand c'est une entreprise qui est titulaire du nom de domaine. La réponse de l'étape 2 contient alors contact_roles avec person. Envoie person avec les informations : "contact_person" utilise la personne de contact de l'entreprise, ou envoie l'ID de l'un de tes contacts qui est une personne physique.

Étape 4 : vérifier que le contact est prêt

Refais l'étape 2. La liste est vide ? Le contact est alors prêt. Tu peux aussi le voir avec GET /v2/contacts : ready_tlds indique toutes les extensions pour lesquelles le contact est prêt.

Tu peux maintenant enregistrer un nom de domaine avec ce contact comme titulaire. Envoie son ID dans contact_id. Découvre comment commander des noms de domaine avec l'API.

Bon à savoir

• Tu peux aussi envoyer les informations avec une commande. Enregistre ou transfère un nom de domaine, et ajoute les informations dans required_info. Nous les vérifions et les enregistrons dans le contact.
• Le contact ne convient pas à l'extension ? Certaines extensions n'acceptent qu'une entreprise, ou qu'une personne physique. Tu reçois alors REG_006. Utilise un autre contact.
• Tu as reçu REG_005 ? Le contact a alors déjà toutes les informations pour cette extension.
• Toutes les extensions ne demandent pas d'informations supplémentaires. Pour le .com, par exemple, la vérification de l'étape 2 donne généralement tout de suite une liste vide.

Besoin d'aide ? Contacte-nous par WhatsApp, Telegram ou e-mail.