Tu veux un nom de domaine avec des caractères spéciaux, comme münchen.de ou café.fr ? Sur Internet, un tel nom de domaine s'écrit en punycode : uniquement des lettres simples, des chiffres et des tirets, avec xn-- au début. Ainsi, münchen.de devient xn--mnchen-3ya.de.
Tu commandes ces noms de domaine avec les mêmes appels API que n'importe quel autre nom de domaine. Ce guide explique ce qui change. Tu n'as encore jamais commandé via notre API ? Lis d'abord comment commander des noms de domaine avec l'API.
Étape 1 : convertir le nom de domaine
Envoie le nom de domaine tel que tu l'écris. Tu n'as pas besoin de clé API pour ça :
POST https://backend.site.fr/v2/domain_names/punycode
Content-Type: application/json
Dans le corps, tu envoies input, par exemple münchen.de. La réponse contient :
- punycode : le nom de domaine en punycode, comme xn--mnchen-3ya.de.
- language_codes : uniquement si l'extension demande la langue du nom de domaine. Plus bas, tu verras comment choisir le bon code.
Nous vérifions aussi si l'extension accepte ces caractères. Ce n'est pas le cas de toutes : le .nl, par exemple, ne propose pas de noms de domaine avec des caractères spéciaux. Tu reçois alors une erreur, et supported_tlds donne la liste des extensions qui les acceptent.
Tu veux d'abord savoir si une extension accepte les caractères spéciaux ? Demande alors les informations de l'extension, sans le point. Là non plus, tu n'as pas besoin de clé API :
GET https://backend.site.fr/v2/tlds?extension=com
La réponse indique isIDN: true ? L'extension accepte alors les noms de domaine avec des caractères spéciaux.
L'extension demande-t-elle une langue ?
Regarde la réponse de l'étape 1 :
- La réponse ne contient pas language_codes ? L'extension ne demande alors pas de langue. Tu n'envoies pas language_code.
- La réponse contient language_codes ? Choisis alors le code de la langue de ton nom de domaine. Tu l'envoies à l'étape 3.
La liste donne uniquement les codes, et chaque registre les écrit à sa façon. Certains utilisent deux lettres minuscules, comme « de » pour l'allemand. D'autres utilisent trois lettres majuscules, comme « GER » pour .com et .net. Recopie le code exactement comme il figure dans la liste, en respectant les majuscules et les minuscules.
Voici les codes de nos langues :
- Néerlandais : nl ou DUT
- Allemand : de ou GER
- Français : fr ou FRE
- Espagnol : es ou SPA
- Polonais : pl ou POL
- Suédois : sv ou SWE
- Slovène : sl ou SLV
- Croate : hr ou SCR
Le code de ta langue ne figure pas dans language_codes ? Certaines extensions ont aussi des codes pour tout un alphabet, comme latn ou und-Latn pour l'alphabet latin, ou cyrl pour l'alphabet cyrillique. Choisis alors celui qui correspond aux lettres de ton nom de domaine. Aucun code ne convient ? Cette extension n'accepte alors pas les noms de domaine dans ta langue. Choisis une autre extension.
Étape 2 : vérifier s'il est encore libre
GET https://backend.site.fr/v2/domain_names/check_availability?domain_name=xn--mnchen-3ya.de
Utilise ici le punycode. Il ne contient aucun caractère spécial : tu peux donc le mettre tel quel dans l'adresse web. Cet appel ne demande pas non plus de clé API.
Étape 3 : commander le nom de domaine
POST https://backend.site.fr/v2/domain_names/register
X-API-Key: your API key
Content-Type: application/json
Dans le corps, tu envoies domain_name, en punycode ou tel que tu l'écris. Nous le stockons toujours en punycode. Ta clé API a besoin de l'autorisation domains.order.create, comme pour toute commande de nom de domaine.
La réponse de l'étape 1 contenait language_codes ? Envoie alors aussi language_code, avec le code que tu as choisi. Pour müller.com, c'est GER (allemand). Un code qui ne figure pas dans la liste est refusé, et rien n'est débité.
Un transfert se passe de la même façon, avec POST /v2/domain_names/transfer. Tout le reste fonctionne comme pour n'importe quel autre nom de domaine : dry_run, l'Idempotency-Key, expected_price et les codes d'erreur. Teste donc d'abord avec dry_run.
Bon à savoir
- Les majuscules deviennent des minuscules. MÜNCHEN.de et münchen.de sont le même nom de domaine.
- ß n'est pas la même chose que ss. straße.de (xn--strae-oqa.de) et strasse.de sont deux noms de domaine distincts.
- Tu veux retrouver les caractères spéciaux ? POST /v2/domain_names/unicode reconvertit le punycode en écriture normale. Ainsi, xn--mller-kva.com devient müller.com. Aucune clé API n'est nécessaire.
- Certains logiciels affichent le punycode. Certains logiciels de messagerie et navigateurs anciens affichent xn--mnchen-3ya.de au lieu de münchen.de. Les deux mènent au même site web.
Besoin d'aide ? Contacte-nous par WhatsApp, Telegram ou e-mail.





