WAPI - Contacts de domaine

Dans cet article, vous trouverez des informations sur la gestion des contacts de domaine avec les TLD suivants :

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

ainsi que sur les commandes suivantes :

• contact-check - vérifier la disponibilité des contacts
• contact-info - liste des 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 - envoie l'AUTH-ID du contact

---

Contacts de domaines par les différents registres

Chaque registre de domaine gère les contacts différemment, il existe des règles différentes pour les identifiants de contact, les éléments obligatoires dans les détails, etc.

CZ Domaines

Lors de la création d'un contact pour un domaine CZ, vous pouvez spécifier un nom. Utilisez le contrôle de contact 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 ne spécifiez pas de nom lors de la création d'un contact, le système en génère un automatiquement.

Dans les détails du contact, vous pouvez définir :

• cname - nom du contact (uniquement lors de la création d'un nouveau contact) ; omettre ce paramètre ou le laisser vide pour générer un nom pseudo-aléatoire)
• entreprise
• fname - nom - obligatoire
• lname - nom de famille - obligatoire
• email - obligatoire
• téléphone - numéro de téléphone +XXX XXXXXXXXX
• fax - numéro de fax +XXX XXXXXXXXX
• dic - Numéro d'identification de la TVA
• addr_street - adresse et numéro de rue - obligatoire
• addr_city - adresse de la ville - obligatoire
• addr_zip - Code postal - obligatoire
• addr_country - pays (code ISO à deux lettres, minuscules) - obligatoire
• addr_state - État ou région
• ident_type - type de document d'identité (ico (identifiant d'entreprise), op (identifiant personnel), birthday (date de naissance au format DD.MM.YYYY), passeport, mpsv (identifiant MPSV)).
• ident - Numéro du document d'identité (en fonction de ident_type)
• notify_email - adresse électronique de notification
• disclose_phone - cacher le téléphone
• disclose_fax - cacher le fax
• disclose_email - cacher l'email
• disclose_ident - cacher le numéro de la pièce d'identité
• disclose_notify_email - cacher l'email de notification

Pour les contacts du domaine CZ, il est possible de masquer certains éléments dans les détails du contact. Utilisez les entrées disclose_* dans les détails du contact avec un indicateur 0/1 (1 = caché, 0 = public) pour spécifier si cette information doit être cachée. Si ces informations sont marquées comme étant cachées, elles ne peuvent pas être consultées sans autorisation.

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

• del_addr=1 - adresse de livraison acive (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, minuscules) (obligatoire)

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

Domaines de l'UE

Lorsque vous créez un contact dans le registre EURid, vous ne pouvez pas spécifier son nom. Le système l'attribue toujours automatiquement.

Dans les détails du contact, vous pouvez définir :

• entreprise
• fname - nom - obligatoire
• lname - nom de famille - obligatoire
• email - obligatoire
• téléphone - numéro de téléphone +XXX XXXXXXXXX
• fax - numéro de fax +XXX XXXXXXXXX
• dic - Numéro d'identification de la TVA
• addr_street - adresse et numéro de rue - obligatoire
• addr_city - adresse de la ville - obligatoire
• addr_zip - Code postal - obligatoire
• addr_country - pays (code ISO à deux lettres, minuscules) - obligatoire
• addr_state - État ou région

Domaines SK

Lors de la création d'un contact pour un domaine SK, vous pouvez spécifier un nom. Utilisez le contrôle de contact 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 du contact est de 5 caractères, la longueur maximale est de 16 caractères. Si vous ne spécifiez 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 est uniquement composé de chiffres).

Dans les détails du contact, vous pouvez définir :

• cname - nom du contact (uniquement lors de la création d'un nouveau contact) ; omettre ce paramètre ou le laisser vide pour générer un nom pseudo-aléatoire)
• entreprise
• fname - nom - obligatoire
• lname - nom de famille - obligatoire
• email - obligatoire
• téléphone - numéro de téléphone +XXX XXXXXXXXX
• fax - numéro de fax +XXX XXXXXXXXX
• dic - Numéro d'identification de la TVA
• addr_street - adresse et numéro de rue - obligatoire
• addr_city - adresse de la ville - obligatoire
• addr_zip - Code postal - obligatoire
• addr_country - pays (code ISO à deux lettres, 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'identification de l'entreprise)
• disclose_name - cacher le nom
• disclose_org - cacher le nom de l'entreprise
• disclose_addr - cacher l'adresse publicitaire
• disclose_phone - cacher le téléphone
• disclose_fax - cacher le fax
• disclose_email - cacher l'adresse électronique

Domaines PL

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

Dans les détails du contact, vous pouvez définir :

• entreprise
• fname - nom, ne peut être modifié pour legal_type = individual - obligatoire
• lname - nom de famille, ne peut être modifié pour legal_type = individu - obligatoire
• email - obligatoire
• téléphone - numéro de téléphone +XXX XXXXXXXXX
• fax - numéro de fax +XXX XXXXXXXXX
• dic - Numéro d'identification de la TVA
• addr_street - adresse et numéro de rue - obligatoire
• addr_city - adresse de la ville - obligatoire
• addr_zip - Code postal - obligatoire
• addr_country - pays (code ISO à deux lettres, minuscules) - obligatoire
• addr_state - État ou région
• legal_type - type juridique (société, individu), ne peut être modifié - obligatoire

Domaines gTLD et nTLD

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

Dans les détails du contact, vous pouvez définir :

• entreprise
• fname - nom - obligatoire
• lname - nom de famille - obligatoire
• email - obligatoire
• téléphone - numéro de téléphone +XXX XXXXXXXXX
• fax - numéro de fax +XXX XXXXXXXXX
• dic - Numéro d'identification de la TVA
• addr_street - adresse et numéro de rue - obligatoire
• addr_city - adresse de la ville - obligatoire
• addr_zip - Code postal - obligatoire
• addr_country - pays (code ISO à deux lettres, minuscules) - obligatoire
• addr_state - État ou région

---

contact-check

Utilisez la demande de vérification de contact pour vérifier la disponibilité d'un nom de contact.

Paramètres

• tld - TLD pour lequel le contact doit être créé (par exemple, eu)
• cname - nom du contact

Valeurs de retour

• 1000 - le contact est gratuit et peut être utilisé
• 2201 - TLD non valide
• 2216 - format de contact non valide
• 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éter la commande ultérieurement

Données de réponse

La demande ne renvoie aucune donnée.

Modèles

Demande 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

La commande contact-info permet d'obtenir des informations détaillées sur un contact.

Paramètres

• tld - TLD
• cname - nom du contact
• auth_info - contact AUTH-ID - facultatif (si le domaine le permet, la saisie de l'AUTH-ID révèlera les données cachées du contact)

Valeurs de retour

• 1000 - contact Informations reçues avec succès
• 2201 - TLD non valide
• 2216 - syntaxe de contact non valide 
• 3228 - valeur non supportée
• 3229 - Erreur de chargement du contact
• 4212 - erreur de connexion

Données de réponse

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

Modèles

Demande JSON :

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

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

---

créer un contact

Utilisez la requête contact-create pour créer un nouveau contact que vous pourrez 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 des registres individuels dans le chapitre Contacts de domaines par des registres individuels.

Paramètres

• tld - domaine TLD
• contact - tableau d'éléments de contact :
  • cname - nom du contact (vide = générer automatiquement)
  • fname - nom
  • lname - nom de famille
  • entreprise - entreprise
  • 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, minuscules)
  • téléphone
  • fax
  • courriel
  • autres articles en fonction du registre

Valeurs de retour

• 1000 = le contact a été créé avec succès
• 2201 = tld non valide
• 2216 = nom de contact non valide
• 2218 = le nom du contact est automatiquement créé
• 2219 = société de poste non remplie
• 2220 = le nom de l'article n'est pas renseigné
• 2221 = nom de famille non renseigné 
• 2222 = email non rempli 
• 2223 = format de l'email incorrect
• 2224 = email2 non rempli
• 2225 = email2 mauvais format
• 2226 = téléphone non rempli
• 2227 = téléphone format incorrect
• 2228 = fax non rempli
• 2229 = format de fax incorrect 
• 2230 = l'ID de l'entreprise n'est pas renseigné 
• 2231 = format incorrect de l'identifiant de l'entreprise
• 2232 = Numéro de TVA non renseigné
• 2233 = Numéro de TVA au mauvais format
• 2234 = rue non remplie
• 2235 = ville non remplie
• 2236 = ZIP non rempli
• 2237 = pays non renseigné
• 2238 = pays au mauvais format
• 2239 = état non rempli
• 2240 = autres données non renseignées
• 2241 = autres données format incorrect 
• 3228 = le domaine ne fonctionne pas avec les contacts
• 3230 = échec de la création d'un contact
• 3231 = le nom du 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 réponse

Le contact renvoie les données suivantes :

• cname - nom du contact créé

Modèles

Demande 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 la demande de mise à jour de contact pour modifier les entrées de contact.

Vous trouverez plus d'informations sur l'utilisation des contacts avec des registres individuels dans le chapitre Contacts de domaines par registres individuels.

Paramètres

• tld - TLD
• cname - nom du contact
• auth_info - AUTH-ID
• contact - éléments de contact
  • fname - nom
  • lname - nom de famille
  • entreprise
  • 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, minuscules)
  • téléphone
  • fax
  • courriel
  • autres articles selon le registre

Valeurs de retour

• 1000 = OK
• 2201 = TLD non valide
• 2207 = syntaxe non valide dans le nom du contact
• 2216 = nom de contact non valide
• 2219 = société de poste non remplie
• 2220 = nom de l'article non renseigné
• 2221 = nom de famille non renseigné
• 2222 = email de l'élément non rempli
• 2223 = erreur de format de l'email de l'article
• 2224 = élément non rempli email2
• 2225 = mauvais format d'article email2
• 2226 = téléphone non renseigné
• 2227 = mauvais format d'article téléphone
• 2228 = télécopie de poste non remplie
• 2229 = format de télécopie incorrect
• 2230 = non rempli ID de l'entreprise de l'élément
• 2231 = format d'article erroné ID de l'entreprise
• 2232 = rubrique non remplie Numéro de TVA
• 2233 = mauvais format d'article Numéro de TVA
• 2234 = rue non remplie
• 2235 = ville non remplie
• 2236 = zip de l'article non rempli
• 2237 = pays de l'article non rempli
• 2238 = mauvais format d'article pays
• 2239 = état de l'article non rempli
• 2240 = poste non renseigné autres données
• 2241 = format d'article erroné par rapport à la date d'origine
• 3211 = erreur - le contact n'a pas été récupéré
• 3238 = erreur d'autorisation
• 3239 = échec de l'opération
• 4202 = contact indisponible - erreur de connexion, réessayer plus tard
• 4215 = échec de la mise en œuvre - erreur de connexion, réessayer plus tard

Données de réponse

La demande ne renvoie aucune donnée.

Modèles

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

Réponse JSON (OK) :

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

contact-transfert

Utilisez la demande de transfert de contact 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 de retour

• 1000 = OK
• 2201 = TLD non valide
• 2215 = paramètre auth_info manquant
• 2216 = identifiant de contact non valide  
• 2244 = Ce domaine ne supporte pas le transfert de contact 
• 3229 = le contact n'est pas disponible
• 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 réponse

La demande ne renvoie aucune donnée.

Modèles

Demande 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 la requête contact-send-auth-info pour envoyer un courriel avec l'AUTH-ID du contact.

Paramètres

• tld - TLD
• cname - nom du contact

Valeurs de retour

• 1000 = OK
• 2201 = TLD non valide
• 2216 = nom de contact non valide
• 2243 = pas autorisé à envoyer auth_info
• 3213 = le contact n'est pas 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 réponse

La demande ne renvoie aucune donnée.

Modèles

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