Le webservice "Domain"

Voici les trois fonctions qui sont actuellement proposées dans le cadre de ce service :

• exist_domain, qui permet de vérifier l'existence d'un domaine,
• city_reserved_domain, qui permet de savoir si un nom de domaine correspond à un nom de commune protégé,
• check_domain, qui permet de vérifier si un domaine est disponible pour l'enregistrement,
• list_domains, qui permet d'obtenir la liste de vos domaines, ainsi que leur date d'anniversaire respective ou plus précisément leur "date ticket fini".

exist_domain

Ce service vous permet de tester facilement si un nom de domaine existe ou pas. Il est semblable au service Whois, il prend en compte uniquement les noms de domaine finis, publiés dans le DNS.

La fonction prend en argument une chaîne de caractères, teste si cette chaîne correspond exactement à un nom de domaine existant. Elle rend en retour :

• 0 si la chaîne de caractères ne correspond à aucun domaine existant. Exemples :
  • 1*én_e.fr : non compatible avec la syntaxe d'un nom de domaine,
  • afnic : il manque l'extension .fr,
  • un-nom-de-domaine-qui-n-existe-pas.fr : ce nom de domaine n'existe pas.
• 1 si la chaîne de caractères correspond à un domaine existant. Exemple :
  • afnic.fr : ce nom de domaine existe.

city_reserved_domain

Ce service vous permet de savoir si un nom de domaine correspond à un nom de commune protégé.

La fonction prend en argument un nom de domaine, teste si le nom de domaine est interdit de dépôt en fonction de la règle sur les noms des communes. Elle rend en retour :

• 0 si le nom de domaine n'est pas interdit par la règle sur les noms de commune. Exemples :
  • rouen.nom.fr : les noms de commune ne sont pas interdit sous .nom.fr,
  • pas-un-nom-de-commune.fr : il n'y a pas de commune de ce nom.
• 1 si le nom de domaine est interdit par la règle sur les noms de commune. Exemple :
  • rouen.fr : ce nom de domaine n'est pas déposable sous .fr car c'est un nom de commune.

Ce service vous permet de tester facilement si un nom de domaine est libre ou pas. Vous pouvez facilement intégrer ce service dans votre système d'information. Contrairement au service Whois, il prend également en compte les noms de domaine en cours de création et les noms interdits.

La fonction prend en argument un nom de domaine, et rend en retour une structure composée de trois champs :

• un booléen, "free", qui indique si le nom de domaine est libre,
• un entier, "reason" qui indique pourquoi un domaine n'est pas libre si le booléen précédent est faux,
• et une chaîne de caractères, "message" qui donne une explication en anglais.

Les causes possibles de réponse négative sont :

• 0 : problème de connexion à la base de données
• 1 : le nom de domaine est déjà enregistré
• 2 : un nom de domaine est déjà enregistré à l'identique dans l'une des extensions du domaine public
• 4 : une opération est en cours pour ce nom de domaine
• 5 : nom de domaine interdit (termes fondamentaux)
• 51 : nom de domaine réservé pour les communes
• 52 (pending delete) : le nom de domaine a été supprimé dans les 7 derniers jours (seul le bureau d'enregistrement qui en avait la gestion peut le déposer)
• 100 : mauvaise syntaxe du nom de domaine
• > 1000 : autre erreur interne

Cette méthode vous permet de connaître la liste de vos domaines. Elle ne prend pas de paramètres et rend un tableau de structures. Chaque structure a un champ "domain" et un champ "anniversary", donnant le nom du domaine, et sa date d'anniversaire.