WAPI – Contacts de domaine

Dans cet article, vous trouverez des informations sur la gestion des contacts de domaine pour les TLD pris en charge suivants :

• CZ
• EU
• SK
• PL
• gTLD et nTLD

et également sur les commandes suivantes :

• contact-check – vérifier la disponibilité du contact
• contact-info – lister les informations du contact
• contact-create – créer un nouveau contact
• contact-update – modifier les données du contact
• contact-transfer – transférer un contact depuis un autre registrar
• contact-send-auth-info – envoyer l'AUTH-ID du contact

---

Contacts de domaine par registre

Chaque registre de domaines gère les contacts différemment ; les règles relatives aux identifiants de contact, aux éléments obligatoires des détails, etc., varient.

Domaines CZ

Lors de la création d’un contact pour un domaine CZ, vous pouvez indiquer un nom. Utilisez le contact-check pour vérifier si le nom choisi est disponible (non utilisé, bloqué, ..).

Le nom du contact ne peut contenir que des lettres majuscules de l’alphabet anglais, des chiffres et un trait d’union. Si vous n’indiquez pas de nom lors de la création d’un contact, le système en génère un automatiquement.

Dans le détail du contact, vous pouvez définir :

• cname – nom du contact (uniquement lors de la création d'un nouveau) ; omettez ce paramètre ou laissez-le vide pour générer un nom pseudo-aléatoire)
• société
• fname – nom – obligatoire
• lname – nom de famille – obligatoire
• e-mail – obligatoire
• phone – numéro de téléphone +XXX XXXXXXXXX
• fax – numéro de fax +XXX XXXXXXXXX
• dic – numéro de TVA
• addr_street – rue et numéro de maison – obligatoire
• addr_city – ville – obligatoire
• addr_zip – code postal – obligatoire
• addr_country – pays (code ISO à deux lettres, en minuscules) – obligatoire
• addr_state – état ou région
• ident_type – type de document d'identité (ico (ID de société), op (pièce d'identité personnelle), birthday (date de naissance au format DD.MM.YYYY), passport, mpsv (identifiant MPSV))
• ident – numéro du document d'identité (selon ident_type)
• notify_email – adresse e-mail de notification
• disclose_phone – masquer le téléphone
• disclose_fax – masquer le fax
• disclose_email – masquer l'e-mail
• disclose_ident – masquer le numéro du document d'identité
• disclose_notify_email – masquer l'e-mail de notification

Pour les contacts de domaines CZ, il est possible de masquer certains éléments des détails du contact. Utilisez disclose_* entrées dans le détail du contact avec un indicateur 0/1 (1 = masqué, 0 = public) pour indiquer si cette information doit être masquée. Si une information est marquée comme masquée, elle ne peut pas être consultée sans autorisation.

Depuis la mi-janvier 2018, vous pouvez définir un adresse de livraison pour les contacts de domaines CZ. Lors de la création/modification d’un contact, saisissez les éléments suivants :

• del_addr=1 – adresse de livraison active (obligatoire)
• del_addr_street1 – rue (obligatoire)
• del_addr_street2 – rue (facultatif)
• del_addr_street3 – rue (facultatif)
• del_addr_city – ville (obligatoire)
• del_addr_state – état ou région
• del_addr_country – pays (code ISO à deux lettres, en minuscules) (obligatoire)

Pour désactiver l’adresse de livraison d’un contact, saisissez del_addr=0 lors de la création/modification d'un contact.

Domaines EU

Lors de la création d’un contact dans le registre EURid, vous ne pouvez pas indiquer son name. Le système l'attribue toujours automatiquement.

Dans le détail du contact, vous pouvez définir :

• société
• fname – nom – obligatoire
• lname – nom de famille – obligatoire
• e-mail – obligatoire
• phone – numéro de téléphone +XXX XXXXXXXXX
• fax – numéro de fax +XXX XXXXXXXXX
• dic – numéro de TVA
• addr_street – rue et numéro de maison – obligatoire
• addr_city – ville – obligatoire
• addr_zip – code postal – obligatoire
• addr_country – pays (code ISO à deux lettres, en minuscules) – obligatoire
• addr_state – état ou région

Domaines SK

Lors de la création d’un contact pour un domaine SK, vous pouvez indiquer un nom. Utilisez le contact-check pour vérifier si le nom choisi est disponible (non utilisé, bloqué, ..).

Le nom du contact ne peut contenir que des lettres majuscules de l’alphabet anglais, des chiffres, des tirets et des points. La longueur minimale du nom de contact est de 5 caractères, la longueur maximale de 16 caractères. Si vous n’indiquez pas de nom lors de la création d’un contact, le système le génère automatiquement. Le format du nom de contact généré automatiquement est WEDOS-XXX-YYYY (où XXX est une combinaison de lettres et de chiffres et YYYY uniquement des chiffres).

Dans le détail du contact, vous pouvez définir :

• cname – nom du contact (uniquement lors de la création d'un nouveau) ; omettez ce paramètre ou laissez-le vide pour générer un nom pseudo-aléatoire)
• société
• fname – nom – obligatoire
• lname – nom de famille – obligatoire
• e-mail – obligatoire
• phone – numéro de téléphone +XXX XXXXXXXXX
• fax – numéro de fax +XXX XXXXXXXXX
• dic – numéro de TVA
• addr_street – rue et numéro de maison – obligatoire
• addr_city – ville – obligatoire
• addr_zip – code postal – obligatoire
• addr_country – pays (code ISO à deux lettres, en minuscules) – obligatoire
• addr_state – état ou région
• ident_type – type de sujet, ne peut être défini qu'une seule fois (PERS = personne physique, CORP = société)
• ident – valeur d'identification (PERS = date de naissance au format RRRR-MM-DD, CORP = numéro d'entreprise)
• disclose_name – masquer le nom
• disclose_org – masquer le nom de la société
• disclose_addr – masquer l'adresse
• disclose_phone – masquer le téléphone
• disclose_fax – masquer le fax
• disclose_email – masquer l'adresse e-mail

Domaines PL

Lors de la création d’un contact PL, vous ne pouvez pas indiquer son name. Le système l'attribue toujours automatiquement.

Dans le détail du contact, vous pouvez définir :

• société
• fname – nom, non modifiable pour legal_type = individual – obligatoire
• lname – nom de famille, non modifiable pour legal_type = individual – obligatoire
• e-mail – obligatoire
• phone – numéro de téléphone +XXX XXXXXXXXX
• fax – numéro de fax +XXX XXXXXXXXX
• dic – numéro de TVA
• addr_street – rue et numéro de maison – obligatoire
• addr_city – ville – obligatoire
• addr_zip – code postal – obligatoire
• addr_country – pays (code ISO à deux lettres, en minuscules) – obligatoire
• addr_state – état ou région
• legal_type – type juridique (company, individual), non modifiable – obligatoire

Domaines gTLD et nTLD

Lors de la création d’un contact pour les domaines gTLD et nTLD, vous ne pouvez pas indiquer son nom : le système le crée automatiquement.

Dans le détail du contact, vous pouvez définir :

• société
• fname – nom – obligatoire
• lname – nom de famille – obligatoire
• e-mail – obligatoire
• phone – numéro de téléphone +XXX XXXXXXXXX
• fax – numéro de fax +XXX XXXXXXXXX
• dic – numéro de TVA
• addr_street – rue et numéro de maison – obligatoire
• addr_city – ville – obligatoire
• addr_zip – code postal – obligatoire
• addr_country – pays (code ISO à deux lettres, en minuscules) – obligatoire
• addr_state – état ou région

---

contact-check

Utilisez contact-check requête pour vérifier la disponibilité d'un nom de contact.

Paramètres

• tld – TLD pour lequel créer le contact (p. ex. eu)
• cname – nom du contact

Valeurs de retour

• 1000 – le contact est libre et peut être utilisé
• 2201 – TLD invalide
• 2216 – format de contact invalide
• 2218 – le nom est généré automatiquement (pour certains TLD, il n'est pas possible de spécifier un nom de contact)
• 3231 – le contact existe déjà
• 3233 – le contact ne peut pas être utilisé
• 3234 – le contact ne peut pas être utilisé – en quarantaine
• 3235 – le contact ne peut pas être utilisé – réservé
• 3236 – le contact ne peut pas être utilisé – bloqué
• 4211 – échec de la vérification – erreur de communication, répétez la commande plus tard

Données de la réponse

La requête ne renvoie aucune donnée.

Modèles

Requête JSON :

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

Réponse JSON (OK) :

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

---

contact-info

Le contact-info commande renvoie des informations détaillées sur un contact.

Paramètres

• tld – TLD – obligatoire
• cname – nom du contact – obligatoire
• auth_info – AUTH-ID du contact – facultatif (si le domaine le prend en charge, la saisie de l'AUTH-ID révélera les données masquées du contact)
• reg_key – ID du registre – facultatif

Valeurs de retour

• 1000 – Informations de contact reçues avec succès
• 2201 – TLD invalide
• 2216 – syntaxe de contact invalide
• 3215 – échec de l'envoi des informations d'authentification du contact
• 3228 – valeur non prise en charge
• 3229 – erreur lors du chargement du contact
• 3236 – contact bloqué
• 4212 – erreur de connexion
• 5001 – non connecté

Données de la réponse

En cas de succès (code 1000), la commande renvoie les informations sur le contact dans le nœud contact.

Modèles

Requête JSON (contact 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",
    }
  }
}

Réponse 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": ""
        }
      }
    }
  }
}

Réponse JSON (contact introuvable) :

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

---

contact-create

Utilisez contact-create requête pour créer un nouveau contact que vous pouvez utiliser avec vos domaines enregistrés auprès du registre correspondant. Chaque contact est identifié par son nom, qui est toujours unique. Vous trouverez plus d'informations sur l'utilisation des contacts avec les différents registres dans le chapitre Contacts de domaine par registre.

Paramètres

• tld – TLD du domaine
• contact – tableau d'éléments de contact :
  • cname – nom du contact (vide = génération automatique)
  • fname – nom
  • lname – nom de famille
  • société – société
  • addr_street – rue et numéro de maison
  • addr_city – ville
  • addr_zip – code postal
  • addr_state – état ou région
  • addr_country – pays (code ISO à deux lettres, en minuscules)
  • phone
  • fax
  • e-mail
  • autres éléments en fonction du registre

Valeurs de retour

• 1000 = le contact a été créé avec succès
• 2201 = tld invalide
• 2216 = nom de contact invalide
• 2218 = le nom de contact est créé automatiquement
• 2219 = élément société non renseigné
• 2220 = le nom de l'élément n'est pas renseigné
• 2221 = nom de famille non renseigné
• 2222 = e-mail non renseigné
• 2223 = e-mail au mauvais format
• 2224 = email2 non renseigné
• 2225 = email2 au mauvais format
• 2226 = téléphone non renseigné
• 2227 = téléphone au mauvais format
• 2228 = fax non renseigné
• 2229 = fax au mauvais format
• 2230 = numéro d'entreprise non renseigné
• 2231 = numéro d'entreprise au mauvais format
• 2232 = Numéro de TVA non renseigné
• 2233 = Numéro de TVA au mauvais format
• 2234 = rue non renseignée
• 2235 = ville non renseignée
• 2236 = Code postal non renseigné
• 2237 = pays non renseigné
• 2238 = pays au mauvais format
• 2239 = région non renseignée
• 2240 = autres données non renseignées
• 2241 = autres données au mauvais format
• 3228 = le domaine ne fonctionne pas avec les contacts
• 3230 = échec de la création d'un contact
• 3231 = le nom de contact est déjà utilisé
• 3232 = le contact ne peut pas être utilisé – raison inconnue
• 3233 = le contact ne peut pas être utilisé
• 3234 = le contact ne peut pas être utilisé – en quarantaine
• 3235 = le contact ne peut pas être utilisé – réservé
• 3236 = le contact ne peut pas être utilisé – bloqué
• 3237 = le contact est déjà enregistré chez nous
• 4211 = échec de la vérification du contact – erreur de communication
• 4213 = échec de la création d'un contact – erreur de communication

Données de la réponse

Le contact renvoie les données suivantes :

• cname – nom du contact créé

Modèles

Requête 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"
      }
    }
  }
}

Réponse 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

Utilisez contact-update requête pour modifier les entrées d'un contact.

Vous trouverez plus d’informations sur la gestion des contacts avec les différents registres dans le chapitre Contacts de domaine par registre.

Paramètres

• tld – TLD
• cname – nom du contact
• auth_info – AUTH-ID
• contact – éléments de contact
  • fname – nom
  • lname – nom de famille
  • société
  • addr_street – rue et numéro
  • addr_city – ville
  • addr_zip – code postal
  • addr_state – état ou région
  • addr_country – pays (code ISO à deux lettres, en minuscules)
  • phone
  • fax
  • e-mail
  • autres éléments selon le registre

Valeurs de retour

• 1000 = OK
• 2201 = TLD invalide
• 2207 = erreur de syntaxe dans le nom de contact
• 2216 = nom de contact invalide
• 2219 = élément société non renseigné
• 2220 = élément nom non renseigné
• 2221 = élément nom de famille non renseigné
• 2222 = élément e-mail non renseigné
• 2223 = mauvais format de l'élément e-mail
• 2224 = élément email2 non renseigné
• 2225 = mauvais format de l'élément email2
• 2226 = élément téléphone non renseigné
• 2227 = mauvais format de l'élément téléphone
• 2228 = élément fax non renseigné
• 2229 = mauvais format de l'élément fax
• 2230 = élément numéro d'entreprise non renseigné
• 2231 = mauvais format de l'élément numéro d'entreprise
• 2232 = élément numéro de TVA non renseigné
• 2233 = mauvais format de l'élément numéro de TVA
• 2234 = élément rue non renseigné
• 2235 = élément ville non renseigné
• 2236 = élément code postal non renseigné
• 2237 = élément pays non renseigné
• 2238 = mauvais format de l'élément pays
• 2239 = élément région non renseigné
• 2240 = élément autres données non renseigné
• 2241 = mauvais format de l'élément dans les autres données
• 3211 = erreur – échec de la récupération du contact
• 3238 = erreur d'autorisation
• 3239 = échec de l'opération
• 4202 = contact indisponible – erreur de connexion, réessayez plus tard
• 4215 = échec de la mise en œuvre – erreur de connexion, réessayez plus tard

Données de la réponse

La requête ne renvoie aucune donnée.

Modèles

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

Réponse JSON (OK) :

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

contact-transfer

Utilisez contact-transfer requête pour transférer un contact d'un autre registrar vers WEDOS.

Paramètres

• tld – TLD
• cname – nom du contact
• auth_info – AUTH-ID

Valeurs de retour

• 1000 = OK
• 2201 = TLD invalide
• 2215 = paramètre auth_info manquant
• 2216 = identifiant de contact invalide
• 2244 = Ce domaine ne prend pas en charge le transfert de contact
• 3229 = contact indisponible
• 3237 = le contact est déjà enregistré chez nous
• 3240 = erreur d'autorisation
• 3241 = échec du transfert
• 4216 = échec – erreur de connexion

Données de la réponse

La requête ne renvoie aucune donnée.

Modèles

Requête 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"
    }
  }
}

Réponse JSON (OK) :

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

---

contact-send-auth-info

Utilisez contact-send-auth-info requête pour envoyer un e-mail contenant l'AUTH-ID du contact.

Paramètres

• tld – TLD
• cname – nom du contact

Valeurs de retour

• 1000 = OK
• 2201 = TLD invalide
• 2216 = nom de contact invalide
• 2243 = envoi de auth_info non autorisé
• 3213 = contact indisponible
• 3215 = échec de l'envoi de l'auth-id
• 3228 = le contact n'est pas pris en charge pour ce domaine
• 4217 = échec de l'envoi – erreur de communication

Données de la réponse

La requête ne renvoie aucune donnée.

Modèles

Requête JSON :

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

Réponse JSON (OK) :

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