Services web du registre

Généralités

La documentation de ces services s'adresse aux prestataires internet déjà membres de l'AFNIC et, pour information uniquement, à ceux qui souhaiteraient le devenir.

Si vous désirez une introduction aux services web, vous pouvez consulter le cours de l'AFNIC.

Tous nos services web utilisent le protocole SOAP. Le lien de la phrase précédente vous emmènera à un site web décrivant les mises en œuvre de SOAP pour votre langage de programmation favori.

Nous donnons des exemples de programmes clients dans différents languages. Nous proposons pour chaque service un fichier WSDL : il s'agit d'un fichier qui décrit, dans un méta-langage, comment est fait le service. Il précise ainsi quelles sont les méthodes disponibles, quels paramètres il faut leur passer, lequel de nos serveurs contacter pour exécuter le service, etc. En principe, il existe dans votre langage favori au moins une librairie SOAP capable d'utiliser ces fichiers WSDL. L'avantage de ces fichiers est qu'ils vont vous permettre d'intégrer nos webservices à votre système d'information en faisant le moins d'effort possible.

Notez que nous recommandons vivement l'usage de HTTPS pour sécuriser les échanges : vous pourrez ainsi dialoguer de manière chiffrée avec nos serveurs, et vérifier que ce sont bien nos serveurs qui vous répondent. Pour cela, il vous faut juste télécharger notre certificat racine et indiquer son emplacement sur votre machine, dans votre système d'information (nous montrons comment procéder à cette étape dans certains clients que nous donnons en exemple). De votre côté, vous vous authentifierez avec votre code adhérent habituel. Si toutefois votre système d'information ne vous permet pas d'utiliser HTTPS, notez que son usage n'est pas obligatoire, et que vous pouvez accéder aux mêmes services en transformant les URL en https:// par des URL en http:// !

Les services

Voici la liste des services disponibles à l'heure actuelle :

• Domain : il permet d'accéder à des fonctionnalités manipulant des noms de domaines. Vous pourrez ainsi regarder si un nom de domaine est libre, demander la liste des domaines que vous gérez actuellement, etc.
• Form : ce module vous permet de manipuler vos formulaires en cours...
• Ticket : ce module vous permet de manipuler vos tickets en cours...
• Titulaire : ce module permet d'accéder aux informations relatives aux titulaires de noms de domaine. Vous pourrez ainsi obtenir la clé, le Nic-handle et l'adresse e-mail d'un titulaire à partir de ses données invariantes (nom, prénom, date et lieu de naissance).
• Contact : ce module permet de créer des objets contact.
• Query : permet de récupérer le nom du titulaire d'un nom de domaine et d'interroger la base de l'AFNIC sur tous les domaines dont le bureau d'enregistrement a la gestion.

Les modules proposés restent encore incomplets, et seront enrichis dans les semaines à venir. Si pour l'instant les services disponibles ne permettent que de faire des opérations de consultations, il est envisagé de les étendre à des fonctions d'écriture également.

Nous vous suggérons de consulter régulièrement l'API des différents modules. Elle s'enrichira régulièrement !