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

ainsi que sur les commandes suivantes :

• contact-check – vérifier la disponibilité d’un contact
• contact-info – lister les informations de 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 bureau d’enregistrement
• 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é, non 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 contact) ; omettez ce paramètre ou laissez-le vide pour générer un nom pseudo-aléatoire)
• company
• 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 voie – 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 (carte d’identité), 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 dans les 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 cette 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 ou de la 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 :

• company
• 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 voie – 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é, non 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 contact) ; omettez ce paramètre ou laissez-le vide pour générer un nom pseudo-aléatoire)
• company
• 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 voie – 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 = entreprise)
• ident – valeur d’identification (PERS = date de naissance au format RRRR-MM-DD, CORP = numéro d’identification de l’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 :

• company
• fname – pré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 voie – 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 :

• company
• 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 voie – 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 pour vérifier la disponibilité d’un nom de contact.

Paramètres

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

Valeurs retournées

• 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èle les données masquées du contact)
• reg_key – ID du registre – facultatif

Valeurs retournées

• 1000 – informations du contact reçues avec succès
• 2201 – TLD invalide
• 2216 – syntaxe de contact invalide 
• 3215 – échec de l’envoi des informations d’authentification au 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 pour créer un nouveau contact utilisable avec vos domaines enregistrés auprès du registre correspondant. Chaque contact est identifié par son nom, toujours unique. Vous trouverez plus d’informations sur la gestion des contacts auprès des différents registres dans le chapitre Contacts de domaine par registre.

Paramètres

• tld – TLD du domaine
• contact – tableau des éléments de contact :
  • cname – nom du contact (vide = généré automatiquement)
  • fname – prénom
  • lname – nom de famille
  • company – société
  • addr_street – rue et numéro de voie
  • 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 retournées

• 1000 = le contact a été créé avec succès
• 2201 = tld invalide
• 2216 = nom de contact invalide
• 2218 = le nom du contact est créé automatiquement
• 2219 = élément entreprise non renseigné
• 2220 = l’élément name n’est pas renseigné
• 2221 = nom de famille non renseigné 
• 2222 = e-mail non renseigné 
• 2223 = format de l’e-mail incorrect
• 2224 = email2 non renseigné
• 2225 = format d’email2 incorrect
• 2226 = téléphone non renseigné
• 2227 = format du téléphone incorrect
• 2228 = fax non renseigné
• 2229 = format du fax incorrect 
• 2230 = numéro d’identification de l’entreprise non renseigné 
• 2231 = format du numéro d’identification de l’entreprise incorrect
• 2232 = Numéro de TVA non renseigné
• 2233 = Format du numéro de TVA incorrect
• 2234 = rue non renseignée
• 2235 = ville non renseignée
• 2236 = Code postal non renseigné
• 2237 = pays non renseigné
• 2238 = format du pays incorrect
• 2239 = région non renseignée
• 2240 = autres données non renseignées
• 2241 = autres données au format incorrect 
• 3228 = le domaine ne fonctionne pas avec les contacts
• 3230 = échec de la création d’un contact
• 3231 = ce 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 pour modifier les entrées de contact.

Vous trouverez plus d’informations sur la gestion des contacts auprès des 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 – prénom
  • lname – nom de famille
  • company
  • 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 retournées

• 1000 = OK
• 2201 = TLD invalide
• 2207 = syntaxe invalide dans le nom du contact
• 2216 = nom de contact invalide
• 2219 = élément entreprise non renseigné
• 2220 = élément nom non renseigné
• 2221 = élément nom de famille non renseigné
• 2222 = élément e-mail non renseigné
• 2223 = format de l’élément e-mail incorrect
• 2224 = élément email2 non renseigné
• 2225 = format de l’élément email2 incorrect
• 2226 = élément téléphone non renseigné
• 2227 = format de l’élément téléphone incorrect
• 2228 = élément fax non renseigné
• 2229 = format de l’élément fax incorrect
• 2230 = élément numéro d’identification de l’entreprise non renseigné
• 2231 = format de l’élément numéro d’identification de l’entreprise incorrect
• 2232 = élément numéro de TVA non renseigné
• 2233 = format de l’élément numéro de TVA incorrect
• 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 = format de l’élément pays incorrect
• 2239 = élément région non renseigné
• 2240 = élément autres données non renseigné
• 2241 = format de l’élément autres données incorrect
• 3211 = erreur – impossible de récupérer le 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 pour transférer un contact d’un autre bureau d’enregistrement vers WEDOS.

Paramètres

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

Valeurs retournées

• 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 pour envoyer un e-mail contenant l’AUTH-ID du contact.

Paramètres

• tld – TLD
• cname – nom du contact

Valeurs retournées

• 1000 = OK
• 2201 = TLD invalide
• 2216 = nom de contact invalide
• 2243 = envoi d’auth_info non autorisé
• 3213 = contact non disponible
• 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",
  }
}

Cet article vous a-t-il été utile ?

Votre avis nous aide à améliorer nos articles.

OuiNon

Souhaitez-vous nous écrire quelque chose à propos de cet article ? (facultatif)

Votre message est transmis à l'équipe de rédaction de la documentation, qui n'y répond pas. Si vous avez besoin d’aide, contactez-nous via le formulaire de contact. N'indiquez ni mots de passe ni données personnelles.

Ne remplissez pas ce champ