Cet article traite des commandes WAPI spécifiques au service DNS de WEDOS. Pour plus d'informations sur la configuration de WAPI et la résolution des problèmes courants, voir l'article WAPI - Manuel.
Cet article fournit des informations sur les demandes suivantes :
- domains-list - liste des domaines dans le compte client
- domain-check - vérifie si le domaine est disponible
- domain-create - enregistrer un nouveau domaine
- domain-info - obtient des informations sur le domaine
- domain-renew - renouveler un domaine
- domain-update-ns - changer les serveurs DNS du domaine
- domain-transfer-check - vérifier la disponibilité du transfert
- domain-transfer - transférer un domaine depuis un autre bureau d'enregistrement
- domain-send-auth-info - envoyer l'AUTH-ID du domaine
- domain-tld-period-check - vérifier la période de disponibilité
liste des domaines
La requête domains-list renvoie une liste de tous les domaines du compte client et leur statut. Elle renvoie également les noms des domaines supprimés. Si un domaine a plus d'une commande attribuée, la requête le renverra plusieurs fois avec le statut approprié (tel que supprimé).
Paramètres
- statut - filtre par statut (facultatif)
Les états de domaine courants sont les suivants
- fee_waiting - en attente de paiement
- setup_processing - création en cours
- actif
- renew_processing - renouvellement en cours
- expiré
- handicapé
- annulé
- transfer_fee_waiting - en attente de paiement de transfert
- transfer_processing - transfert en cours depuis un autre bureau d'enregistrement
- supprimé
Valeurs de retour
- 1000 - OK
Données de réponse
La commande domains-list renvoie une liste de domaines, dans laquelle chaque domaine contient les entrées suivantes :
- nom - nom de domaine
- status - statut du domaine
Modèles
Demande JSON :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "domains-list",
"clTRID": "your ID",
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "domains-list",
"data": {
"domain": {
"1": {
"name": "domain1.tld",
"status": "status"
},
"0": {
"name": "domain2.tld",
"status": "status"
}
}
}
}
}
vérification du domaine
Utilisez la demande de vérification de domaine pour vérifier si nous pouvons enregistrer un domaine.
La demande de vérification de domaine est soumise à la limite de 100 requêtes de domaine par heure.
Nous ne pouvons pas enregistrer certains domaines, même s'ils n'existent pas actuellement. Les noms peuvent être réservés, bloqués ou leur enregistrement peut être restreint d'une autre manière. Cela dépend toujours du registre concerné, de ses règles ou des litiges en cours.
Paramètres
- name - nom de domaine sans www - obligatoire
Valeurs de retour
- 1000 - le domaine est disponible pour l'enregistrement
- 3201 - le nom de domaine est déjà utilisé
- 3204 - le domaine est en quarantaine
- 3205 - le domaine est réservé
- 3206 - le nom de domaine est bloqué
Données de réponse
Cette demande ne renvoie aucune donnée autre que la valeur de retour.
Modèles
Demande JSON :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "domain-check",
"clTRID": "your ID",
"data": {
"name": "your domain without www"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "domain-check"
}
}
créer un domaine
Utilisez la demande domain-create pour enregistrer un nouveau domaine. La demande est soit synchrone, soit asynchrone, en fonction du domaine TLD.
La demande de création de domaine est soumise à la limite de 100 requêtes de domaine par heure.
Pour tous les domaines, le registre et nous-mêmes exigeons le consentement du propriétaire du domaine aux règles d'enregistrement du nom de domaine. Nos conditions générales vous obligent à familiariser vos clients avec nos conditions générales et celles de l'agent d'enregistrement du nom de domaine ! Si vous ne le faites pas, le domaine peut être supprimé sans dédommagement en cas de litige.
Paramètres
- name - nom de domaine, y compris TLD - obligatoire
- période - nombre d'années - requise
- dns ou nsset - une liste de serveurs DNS ou NSSET (domaines CZ uniquement) - obligatoire
- owner_c - ID de contact du propriétaire - obligatoire
- admin_c - ID du contact administratif - facultatif
- règles - nom et prénom de la personne qui a accepté nos conditions générales et celles du registre (généralement le propriétaire du domaine).
Valeurs possibles du paramètre dns :
- Valeur vide du paramètre DNS - utiliser la valeur par défaut (serveurs DNS WEDOS). Attention, même si vous laissez le paramètre DNS vide, vous devez quand même le spécifier ! Le paramètre NSSET doit toujours contenir une valeur (par ex.
WEDOS). - Configuration DNS propre - ne peut pas être utilisée pour les domaines CZ (chaque enregistrement doit contenir un champ nom, éventuellement addr_ip4 et addr_ip6, les serveurs individuels sont imbriqués dans l'élément serveur). Voir le modèle pour plus de détails.
Valeurs de retour
- 1000 - le domaine a été enregistré avec succès
- 1001 - demande d'enregistrement asynchrone acceptée
- 3002 - insuffisance de crédit sur le compte de crédit
- 3201 - le nom de domaine est déjà utilisé
- 3204 - le domaine est en quarantaine
- 3205 - le domaine est réservé
- 3206 - le nom de domaine est bloqué
- 2201 - TLD non pris en charge
- 2203 - période non valide
- 3221 - échec de la création
- 4207 - La création a échoué - erreur de connexion
Données de réponse
Après l'enregistrement réussi du domaine, les éléments suivants sont renvoyés dans le nœud de données :
- num - numéro de commande
- expiration - date d'expiration du domaine
- crédit - l'état du compte de crédit après la fin de l'opération
- montant - solde créditeur du compte
- monnaie - monnaie
Modèles
Demande JSON avec WEDOS NSSET :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "domain-create",
"clTRID": "your ID",
"data": {
"name": "domain.cz",
"period": "number of years",
"nsset": "WEDOS",
"owner_c": "owner contact ID",
"admin_c": "admin contact ID",
"rules": {
"fname": "Name",
"lname": "Surname"
}
}
}
}
Demande JSON avec son propre DNS :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "domain-create",
"clTRID": "your ID",
"data": {
"name": "domain.tld",
"period": "number of years",
"dns": {
"server1":
{
"name": "ns1.dns-provider.tld"
},
"server2":
{
"name": "ns2.dns-provider.tld"
}
}
},
"owner_c": "domain owner contact ID",
"admin_c": "domain admin contact ID",
"rules": {
"fname": "Name",
"lname": "Surname"
}
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "domain-create",
"data": {
"num": "order number",
"expiration": "YYYY-MM-DD"
}
}
}
info-domaine
Utilisez la requête domain-info pour obtenir des informations sur un domaine spécifique.
La commande ne fonctionne que sur les domaines du compte client correspondant.
Paramètres
- name - nom de domaine sans www - obligatoire
Valeurs de retour
- 1000 - la commande a réussi, les données de l'élément contiennent des informations sur le domaine
- 3222 - échec de la récupération de l'objet domaine
- 3216 - Échec de la récupération des informations sur le domaine
- 3223 - le domaine n'appartient pas à votre compte client
- 4205 - erreur en rapport avec le registre
Données de réponse
L'élément de données contient des informations sur le domaine en cas de succès. Les données spécifiques dépendent du type de domaine et d'autres circonstances. Voici les plus importantes :
- nom - nom de domaine
- status - statut du domaine
- owner_c - ID du propriétaire du domaine
- setup_date - date de création
- expiration - date d'expiration
- dns ou NSSET - Liste de serveurs DNS ou NSSET
- éléments avec le préfixe own_ - informations sur le propriétaire du domaine
Certaines informations concernant le domaine ou son propriétaire peuvent être cachées ; dans ce cas, elles ont la valeur HIDDEN.
Modèles
Demande JSON :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "domain-info",
"clTRID": "your ID",
"data": {
"name": "domain.tld"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "domain-info",
"data": {
"domain": {
"name": "domain.tld",
"status": "status",
"owner_c": "owner ID",
"nsset": "WEDOS",
"reg_owner": "",
"reg_creator": "",
"setup_date": "YYYY-MM-DD",
"expiration": "YYYY-MM-DD",
"reg_update": "",
"updated_date": "",
"transfer_date": "",
"dns": {
"server1":
{
"name": "ns1.server-provider.tld"
},
"server2":
{
"name": "ns1.server-provider.tld"
}
}
},
"own_company": "",
"own_name": "",
"own_lname": "",
"own_fname": "",
"own_email": "",
"own_email2": "",
"own_phone": "",
"own_fax": "",
"own_ic": "",
"own_dic": "",
"own_taxpayer": "",
"own_addr_street": "",
"own_addr_city": "",
"own_addr_zip": "",
"own_addr_country": "",
"own_addr_state": "",
"admin_c": "",
"own_other": {
"notify_email": "",
"ident_type": "",
"ident": ""
}
}
}
}
}
domaine-renouvellement
La demande de renouvellement de domaine vous permet de renouveler un domaine qui n'a pas encore fait l'objet d'une demande de renouvellement.
Le système tente automatiquement de renouveler les domaines 30 jours avant leur expiration.
Paramètres
- name - nom de domaine - obligatoire
- période - nombre d'années à renouveler - obligatoire
Valeurs de retour
- 1000 - Le domaine a été renouvelé avec succès
- 2203 - Période de renouvellement non valide
- 2269 - la demande de renouvellement existe déjà
Données de réponse
En cas de succès, cette commande renvoie la nouvelle date d'expiration.
- expiration - date d'expiration du nouveau domaine
Modèles
Demande JSON :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "domain-renew",
"clTRID": "your ID",
"data": {
"name": "your domain name without www",
"period": "number of years"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "domain-renew",
"data": {
"expiration": "YYYY-MM-DD"
}
}
}
domain-update-ns
Utilisez la requête domain-update-ns pour modifier les serveurs DNS ou NSSET du domaine.
Paramètres
- name - nom de domaine - obligatoire
- dns ou nsset - Serveurs DNS ou NSSET pour les domaines CZ - obligatoire
Valeurs possibles du paramètre dns :
- Valeur vide du paramètre DNS - utiliser la valeur par défaut (serveurs DNS WEDOS). Attention, même si vous laissez le paramètre DNS vide, vous devez quand même le spécifier ! Le paramètre NSSET doit toujours contenir une valeur (par ex.
WEDOS). - Configuration DNS propre - ne peut pas être utilisée pour les domaines CZ (chaque enregistrement doit contenir un champ nom, éventuellement addr_ip4 et addr_ip6, les serveurs individuels sont imbriqués dans l'élément serveur). Voir le modèle pour plus de détails.
Valeurs de retour
- 1000 - Les serveurs DNS ont été configurés avec succès
- 2209 - format NSSET non valide (pour les domaines CZ)
- 2210 - format de serveur DNS non valide
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": "domain-update-ns",
"clTRID": "your ID",
"data": {
"name": "domain.tld",
"dns": {
"server1":
{
"name": "ns1.own-dns-server.tld"
},
"server2":
{
"name": "ns1.own-dns-server.tld"
}
}
}
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "domain-update-ns",
}
}
vérification du transfert de domaine
Utilisez la demande de vérification de transfert de domaine pour vérifier si le domaine peut être transféré d'un autre bureau d'enregistrement vers le nôtre.
Le contrôle de transfert de domaine vérification du transfert de domaine est soumis à la limite de 100 requêtes de domaine par heure.
Paramètres
- name - nom de domaine sans www - obligatoire
Valeurs de retour
La demande renvoie généralement les valeurs suivantes :
- 1000 - Le transfert est possible
- 3217 - Échec de l'établissement d'une connexion avec le registre
- 3218 - Le transfert n'est pas possible
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": "domain-transfer-check",
"clTRID": "your ID",
"data": {
"name": "domain.tld"
}
}
}
JSON odpověď (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "domain-transfer-check"
}
}
transfert de domaine
Utilisez la demande de transfert de domaine pour transférer un domaine d'un autre bureau d'enregistrement vers WEDOS.
La demande est synchrone uniquement pour les domaines CZ et EU, c'est-à-dire que pour eux, si l'AUTH-ID est correct, le transfert est effectué immédiatement et vous connaissez le résultat tout de suite. Pour les autres domaines, les transferts sont asynchrones et vous connaîtrez le résultat par le biais d'une notification.
Le transfert de domaine transfert de domaine est soumis à la limite de 100 requêtes de domaine par heure.
Pour tous les domaines, le registre et nous-mêmes exigeons le consentement du propriétaire du domaine aux règles d'enregistrement du nom de domaine. Nos conditions générales vous obligent à familiariser vos clients avec nos conditions générales et celles de l'agent d'enregistrement du nom de domaine ! Si vous ne le faites pas, le domaine peut être supprimé sans dédommagement en cas de litige.
Paramètres
- name - nom de domaine sans www - obligatoire
- auth_info - domaine AUTH-ID - obligatoire
- owner_c - identifiant du propriétaire du domaine - requis uniquement pour certains registres (SK, EU, gTLD)
- dns - configuration du serveur DNS du domaine - facultatif ; disponible uniquement pour les registres qui le prennent en charge (EU, gTLD)
- règles - nom et prénom de la personne qui a accepté nos conditions et celles du registre (généralement le propriétaire du domaine) - obligatoire
Valeurs disponibles pour le paramètre dns :
- Paramètre DNS omis - le domaine conservera les paramètres actuels du serveur DNS. Pendant le transfert, les serveurs DNS actuels seront résolus. S'il n'est pas possible de résoudre les serveurs DNS actuels, le transfert peut entraîner une erreur (gTLD).
- Paramètre DNS vide - le système tentera de définir des serveurs DNS WEDOS par défaut.
- Paramètre DNS avec serveurs - le système tentera de définir ces serveurs DNS.
Valeurs de retour
- 1000 - Domaine transféré avec succès
- 1001 - La demande de transfert a été acceptée, en attente de mise en œuvre
- 2100 - Paramètre requis manquant
- 2101 - Valeur de paramètre invalide
- 2201 - TLD non valide
- 2202 - Format de nom de domaine non valide
- 2204 - L'identifiant de contact du propriétaire du domaine n'est pas spécifié
- 2207 - Identifiant de contact du propriétaire du domaine invalide
- 2210 - Format de serveur DNS non valide
- 2215 - AUTH-ID n'a pas été spécifié et est requis pour ce domaine
- 2245 - Consentement manquant
- 2246 - Erreur dans les données de consentement
- 2252 - Nombre de demandes de domaine dépassé
- 2263 - La longueur de l'AUTH-ID est inférieure à la longueur minimale requise
- 2271 - Format AUTH-ID non valide
- 3001 - Devise du compte de crédit invalide
- 3003 - Informations de facturation du compte de crédit invalides
- 3207 - Le domaine est déjà enregistré chez nous
- 3208 - Échec du transfert en raison d'un problème de date d'expiration
- 3217 - Impossible d'établir une connexion avec le registre
- 3218 - Transfert impossible
- 3219 - Demande de transfert déjà en cours pour ce domaine
- 3220 - Le domaine est déjà enregistré dans notre registre
- 3226 - Échec du transfert de domaine
- 3227 - Erreur d'autorisation sur le registre des domaines
- 3258 - Temps d'arrêt du registre
- 3266 - Transfert impossible car le domaine est expiré
- 3267 - Les serveurs DNS faisant autorité n'ont pas réussi à résoudre les problèmes suivants
- 4002 - Le crédit n'a pas été déduit du compte de crédit
- 4003 - Échec de la création de la période de facturation
- 4206 - Impossible de déterminer si le domaine peut être transféré - erreur de connexion
- 4209 - Échec de la détermination du type de transfert (avec / sans renouvellement)
- 5001 - Erreur de connexion interne
- 5002 - Le prix de transfert n'a pas été calculé
- 5004 - Temps d'arrêt de la facturation
Données de réponse
- num - numéro de commande
- expiration - date d'expiration du domaine
Modèles
Demande JSON :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "domain-transfer",
"clTRID": "your ID",
"data": {
"name": "domain.tld",
"auth_info": "AUTH-ID",
"dns": {
"server1":
{
"name": "ns1.mydns.tld"
},
"server2":
{
"name": "ns2.mydns.tld"
}
}
},
"rules": {
"fname": "Name",
"lname": "Surname"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "domain-transfer",
"data": {
"num": "order number",
"expiration": "YYYY-MM-DD"
}
}
}
domain-send-auth-info
Utilisez la requête domain-send-auth-info pour envoyer l'AUTH-ID d'un domaine à l'adresse électronique du propriétaire du domaine.
Paramètres
- name - nom de domaine - obligatoire
Valeurs de retour
- 1000 - L'AUTH-ID est envoyé à l'email du propriétaire du domaine
- 2243 - L'envoi d'auth_info n'est pas autorisé
- 3209 - Échec de l'envoi d'auth_info
- 3210 - Échec de l'envoi d'auth_info - le domaine n'est pas disponible
- 3222 - Échec de la récupération du domaine
- 3223 - Le domaine n'appartient pas à ce compte client
- 4214 - Échec de l'envoi d'auth_info - erreur de connexion - réessayer plus tard
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": "domain-send-auth-info",
"clTRID": "your ID",
"data": {
"name": "domain.tld"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "domain-send-auth-info"
}
}
domain-tld-period-check
Utilisez la requête domain-tld-period-check pour vérifier si une certaine période d'enregistrement peut être définie pour un TLD.
Paramètres
- tld - TLD
- période - nombre d'années
Valeurs de retour
- 1000 - période pouvant être utilisée pour ce domaine
- 2203 -la période ne peut pas être utilisée pour ce domaine
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": "domain-tld-period-check",
"clTRID": "your ID",
"data": {
"tld": "domain tld",
"period": "number of years"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "domain-tld-period-check"
}
}