Codificatore IDNA

Corpi ACE vuoti, Punycode troncato, caratteri illegali, punti consecutivi, schemi, percorsi e violazioni di lunghezza DNS falliscono con invalid_input che indica l'indice dell'etichetta errata invece di corrompere silenziosamente la stringa.

Codificare un hostname Unicode in ASCII IDNA (ToASCII / xn--)

Invii un corpo JSON con il campo stringa obbligatorio text impostato su un nome di dominio internazionalizzato completo —ad esempio un marchio di città con dieresi seguito da un secondo livello e un TLD classici— e lasci mode al valore predefinito encode oppure imposti mode su encode in modo esplicito. La risposta include result (l'hostname ASCII completo), ascii (la stessa forma di rete), unicode (la vista Unicode piegata), label_count, has_ace true se qualche etichetta ha usato ACE, mode encode e method idna affinché i test possano fissare ogni campo.

Decodificare hostname ACE in Unicode e segnalare etichette non valide

Imposti mode su decode e inserisca in text un hostname ASCII o ACE misto come xn--mnchen-3ya.example.com. Il motore scorre ogni etichetta, rimuove il prefisso xn-- quando presente, valida che il corpo usi solo l'alfabeto di base di lettere, cifre e trattini interni, poi esegue il decodificatore RFC 3492 per recuperare i punti di codice Unicode —inclusi caratteri del piano supplementare rappresentati con coppie surrogato nelle stringhe JavaScript. Le etichette ASCII pure non ACE passano in decode, e le etichette Unicode già presenti in un hostname misto sono accettate e riderivate in ASCII nel campo ascii affinché la risposta offra sempre entrambe le viste. Preferisca questa capacità quando l'intento di ricerca è un codificatore o decodificatore di domini IDNA per hostname completi; esperimenti di corpo Punycode a etichetta singola e risoluzione DNS live appartengono ad altri strumenti. Dopo la decodifica di un'etichetta la ricodifica e richiede un andata e ritorno esatto rispetto al corpo, così stringhe ACE troncate o modificate a mano falliscono chiuse con invalid_input invece di restituire glifi plausibili ma errati. Corpi vuoti dopo xn--, caratteri illegali come punteggiatura, condizioni di overflow, etichette vuote da punti consecutivi e etichette che superano i limiti di lunghezza DNS sollevano un messaggio invalid_input descrittivo che include la posizione dell'etichetta in base uno, così gli strumenti bulk possono evidenziare il segmento errato. Un decode riuscito restituisce result e unicode come forma U-label leggibile, ascii come forma di rete, label_count, has_ace true se era presente ACE, mode decode e method idna. La validazione fallita non viene addebitata sull'API prepagata dopo il rifiuto del motore, il che mantiene economico il decode esplorativo di righe di log sospette e protegge il saldo da successi silenziosi su input spazzatura.

Uso dell'API, prezzi, flussi DNS e limiti pratici

Elabori hostname completi in una sola chiamata: il design multi-etichetta è intenzionale affinché SEO e prodotto coincidano con «codificatore di domini IDNA» invece di costringere i client a dividere e ricongiungere etichette. Quando un'etichetta fallisce, la corregga e reinoltri; un successo parziale non viene mai restituito, il che mantiene semplice il codice client ed evita che hostname a metà convertiti finiscano nel DNS di produzione. Chiami il codificatore di domini IDNA gratuito nel browser per playbook di supporto, demo in aula e controlli puntuali di hostname senza installare trucchi OpenSSL s_client né runtime di linguaggio. Usi l'API prepagata KIT quando un backend, pannello registrar, job di automazione certificati, gateway di posta o SDK necessita dello stesso passo encode o decode a saldo a $0.002 per elemento riuscito; i fallimenti di validazione non consumano mai saldo dopo il rifiuto del motore. Un flusso tipico codifica un hostname di marca Unicode prima di scrivere A-label in un template di zona o elenco server_name di reverse proxy, poi decodifica nomi ACE copiati da intestazioni mail, log di trasparenza dei certificati o oggetti di ticket affinché gli operatori leggano le U-label previste. Gli autori di SDK possono mappare il campo result su un pulsante copia mentre ascii, unicode, label_count e has_ace rendono autoesplicativi gli esempi OpenAPI per chi impara IDNA per la prima volta. Non invii URL complete: rimuova prima schema e percorso e converta solo l'hostname bare affinché il contratto resti stretto e i messaggi di errore restino utilizzabili.