Encodeur IDNA

Corps ACE vides, Punycode tronqué, caractères illégaux, points consécutifs, schémas, chemins et dépassements de longueur DNS échouent avec invalid_input indiquant l'index du libellé fautif au lieu de corrompre silencieusement la chaîne.

Encoder un nom d'hôte Unicode en ASCII IDNA (ToASCII / xn--)

Envoyez un corps JSON avec le champ chaîne obligatoire text fixé à un nom de domaine internationalisé complet —par exemple une marque de ville avec tréma suivie d'un second niveau et d'un TLD classiques— et laissez mode à sa valeur par défaut encode ou définissez mode à encode explicitement. La réponse inclut result (le nom d'hôte ASCII complet), ascii (la même forme filaire), unicode (la vue Unicode pliée), label_count, has_ace true si un libellé a utilisé ACE, mode encode et method idna afin que les tests puissent figer chaque champ.

Décoder les noms d'hôte ACE en Unicode et signaler les libellés invalides

Définissez mode à decode et placez dans text un nom d'hôte ASCII ou ACE mixte tel que xn--mnchen-3ya.example.com. Le moteur parcourt chaque libellé, retire le préfixe xn-- le cas échéant, vérifie que le corps n'utilise que l'alphabet de base des lettres, chiffres et tirets internes, puis exécute le décodeur RFC 3492 pour récupérer les points de code Unicode —y compris les caractères du plan supplémentaire représentés par des paires de substitution dans les chaînes JavaScript. Les libellés ASCII purs non ACE passent en decode, et les libellés Unicode déjà présents dans un nom d'hôte mixte sont acceptés et redérivés en ASCII dans le champ ascii afin que la réponse offre toujours les deux vues. Préférez cette capacité lorsque votre intention de recherche est un encodeur ou décodeur de domaines IDNA pour des noms d'hôte complets ; les expériences de corps Punycode mono-libellé et la résolution DNS en direct appartiennent à d'autres outils. Après décodage d'un libellé, il ré-encode et exige un aller-retour exact contre le corps afin que les chaînes ACE tronquées ou éditées à la main échouent fermées avec invalid_input au lieu de renvoyer des glyphes plausibles mais faux. Corps vides après xn--, caractères illégaux comme la ponctuation, débordements, libellés vides dus à des points consécutifs et libellés dépassant les limites de longueur DNS soulèvent un message invalid_input descriptif incluant la position du libellé en base un, pour que les outils en masse mettent en évidence le segment fautif. Un decode réussi renvoie result et unicode comme forme U-label lisible, ascii comme forme filaire, label_count, has_ace true si une ACE était présente, mode decode et method idna. L'échec de validation n'est pas facturé sur l'API prépayée après rejet du moteur, ce qui garde le decode exploratoire de lignes de journal suspectes peu coûteux tout en protégeant le solde contre un succès silencieux sur des données invalides.

Usage API, tarification, workflows DNS et limites pratiques

Traitez les noms d'hôte complets en un seul appel —le design multi-libellés est volontaire pour que le SEO et le produit correspondent à « encodeur de domaines IDNA » plutôt que d'obliger les clients à découper et recombiner les libellés. N'envoyez pas d'URL complètes : retirez d'abord le schéma et le chemin, et convertissez uniquement le nom d'hôte nu pour que le contrat reste étroit et les messages d'erreur actionnables. Lorsqu'un libellé échoue, corrigez-le et renvoyez ; un succès partiel n'est jamais renvoyé, ce qui garde le code client simple et évite que des noms d'hôte à demi convertis ne fuient vers le DNS de production. Appelez l'encodeur de domaines IDNA gratuit dans le navigateur pour les playbooks de support, démonstrations en classe et contrôles ponctuels de noms d'hôte sans installer de tours OpenSSL s_client ni de runtimes de langage. Utilisez l'API prépayée KIT lorsqu'un backend, panneau registraire, job d'automatisation de certificats, passerelle mail ou SDK a besoin de la même étape encode ou decode sous solde à $0.002 par élément réussi ; les échecs de validation ne consomment jamais le solde après rejet du moteur. Un workflow typique encode un nom d'hôte de marque Unicode avant d'écrire des A-labels dans un modèle de zone ou une liste server_name de reverse proxy, puis décode des noms ACE copiés depuis des en-têtes mail, journaux de transparence des certificats ou sujets de tickets pour que les opérateurs lisent les U-labels prévues. Les auteurs de SDK peuvent mapper le champ result vers un bouton copier tandis que ascii, unicode, label_count et has_ace rendent les exemples OpenAPI explicites pour les lecteurs découvrant IDNA.