IDNA-Kodierer

Leere ACE-Rümpfe, abgeschnittenes Punycode, unzulässige Zeichen, aufeinanderfolgende Punkte, Schemata, Pfade und DNS-Längenverletzungen scheitern mit invalid_input, das den Index des fehlerhaften Labels nennt, statt die Zeichenkette still zu verfälschen.

Unicode-Hostnamen in IDNA-ASCII kodieren (ToASCII / xn--)

Senden Sie einen JSON-Body mit dem Pflicht-Stringfeld text auf einen vollständigen internationalisierten Domänennamen —beispielsweise eine Stadtmarke mit Umlaut gefolgt von klassischer Second-Level- und Top-Level-Domain— und lassen Sie mode beim Standard encode oder setzen Sie mode ausdrücklich auf encode. Die Antwort enthält result (den vollständigen ASCII-Hostnamen), ascii (dieselbe Wire-Form), unicode (die gefaltete Unicode-Ansicht), label_count, has_ace true wenn ein Label ACE nutzte, mode encode und method idna, damit Tests jedes Feld pinnen können.

ACE-Hostnamen nach Unicode dekodieren und ungültige Labels melden

Setzen Sie mode auf decode und legen Sie einen ASCII- oder gemischten ACE-Hostnamen wie xn--mnchen-3ya.example.com in text. Die Engine geht jedes Label durch, entfernt ein führendes xn---Präfix falls vorhanden, prüft, dass der Rumpf nur das Grundalphabet aus Buchstaben, Ziffern und internen Bindestrichen nutzt, und führt den RFC-3492-Dekodierer aus, um Unicode-Codepunkte zu gewinnen —einschließlich Zeichen der ergänzenden Ebenen, die in JavaScript-Strings als Surrogatpaare dargestellt werden. Reine ASCII-Nicht-ACE-Labels passieren beim Decode, und Unicode-Labels, die bereits in einem gemischten Hostnamen vorkommen, werden akzeptiert und im Feld ascii erneut nach ASCII abgeleitet, sodass die Antwort stets beide Sichten bietet. Bevorzugen Sie diese Fähigkeit, wenn Ihre Suchintention ein IDNA-Domain-Kodierer oder -Dekodierer für vollständige Hostnamen ist; Einzellabel-Punycode-Körper-Experimente und Live-DNS-Auflösung gehören zu anderen Werkzeugen. Nach dem Dekodieren eines Labels kodiert sie erneut und verlangt einen exakten Roundtrip gegen den Rumpf, sodass abgeschnittene oder handeditierte ACE-Zeichenketten mit invalid_input geschlossen scheitern statt plausible aber falsche Glyphen zurückzugeben. Leere Rümpfe nach xn--, unzulässige Zeichen wie Interpunktion, Overflow-Zustände, leere Labels durch aufeinanderfolgende Punkte und Labels über DNS-Längenlimits erzeugen eine beschreibende invalid_input-Meldung mit der einsbasierten Labelposition, damit Bulk-Werkzeuge das schlechte Segment hervorheben können. Erfolgreiches Decode liefert result und unicode als lesbare U-Label-Form, ascii als Wire-Form, label_count, has_ace true wenn ACE vorhanden war, mode decode und method idna. Fehlgeschlagene Validierung wird auf der vorausbezahlten API nach Ablehnung durch die Engine nicht berechnet, was exploratives Decode verdächtiger Logzeilen günstig hält und den Saldo vor stillem Erfolg bei Mülleingaben schützt.

API-Nutzung, Preise, DNS-Workflows und praktische Grenzen

Verarbeiten Sie vollständige Hostnamen in einem Aufruf —das Multi-Label-Design ist beabsichtigt, damit SEO und Produkt zu „IDNA-Domain-Kodierer“ passen, statt Clients zu zwingen, Labels selbst zu teilen und zu fügen. Wenn ein Label scheitert, korrigieren Sie es und senden Sie erneut; Teilerfolg wird nie zurückgegeben, was Clientcode einfach hält und halb umgewandelte Hostnamen vor dem Produktions-DNS schützt. Rufen Sie den kostenlosen IDNA-Domain-Kodierer im Browser für Support-Playbooks, Unterrichtsdemos und einmalige Hostname-Prüfungen auf, ohne OpenSSL-s_client-Tricks oder Sprachlaufzeiten zu installieren. Nutzen Sie die vorausbezahlte KIT-API, wenn ein Backend, Registrar-Panel, Zertifikatsautomatisierungsjob, Mail-Gateway oder SDK denselben encode- oder decode-Schritt unter Saldo zu $0.002 pro erfolgreichem Item braucht; Validierungsfehler verbrauchen nach Ablehnung durch die Engine nie Saldo. Ein typischer Workflow kodiert einen Unicode-Marken-Hostnamen, bevor A-Labels in eine Zonenvorlage oder Reverse-Proxy-server_name-Liste geschrieben werden, und dekodiert dann ACE-Namen aus Mail-Headern, Certificate-Transparency-Logs oder Ticketbetreffen, damit Betreiber die beabsichtigten U-Labels lesen können. SDK-Autoren können das result-Feld auf einen Kopierbutton mappen, während ascii, unicode, label_count und has_ace OpenAPI-Beispiele für Erstleser von IDNA selbsterklärend machen. Senden Sie keine vollständigen URLs: entfernen Sie zuerst Schema und Pfad und wandeln Sie nur den bare Hostnamen um, damit der Vertrag schmal und Fehlermeldungen handlungsfähig bleiben.