{"id":"idna-domain-to-ascii","version":"1.0.0","description":"Convert a domain to DNS ASCII with UTS #46 ToASCII, STD3, and DNS lengths.","supported_operations":["convert internationalized domain to ascii","uts 46 toascii","unicode hostname to a-label","punycode a domain name","dns ascii form of an idn","transitional idna to ascii","make a domain safe for dns","idna toascii with std3 rules"],"unsupported_operations":["resolve the domain in dns","parse a full url with a path","check bidi or joiner context"],"semantics":["Map each code point by Unicode 17.0.0 IdnaMappingTable status. Ignored code points are removed. Disallowed and valid code points stay. Deviation code points use the table mapping only when transitional is true; otherwise they stay. Mapped code points use the table mapping, except U+1E9E CAPITAL SHARP S, which becomes U+0073 U+0073 (ss) when transitional is true and U+00DF when transitional is false (UTS #46 revision 33, section 4 step 1).","After mapping, normalize with NFC. The host String.normalize and the Mark category check follow the runtime Unicode version; status values come only from the vendored Unicode 17.0.0 table.","transitional is optional. When the field is omitted, transitional processing is false and the output echoes false. data_version is unicode-17.0.0-uts46-rev33.","CheckBidi and CheckJoiners are not applied. NV8 and XV8 markers are not an extra rejection. There is no DNS lookup and no URL parse.","Disclaimer: format transform only; provides no confidentiality, integrity, or authenticity.","ToASCII (section 4.2): validate each label with CheckHyphens and UseSTD3ASCIIRules, decode an xn-- label and validate it under nontransitional rules, then punycode any remaining non-ASCII label. Punycode is not remapped.","VerifyDnsLength: each label is 1 to 63 octets and the domain, excluding a trailing root dot, is 1 to 253 octets. A trailing root dot is preserved and excluded from the domain-octet count; other empty labels are rejected.","The first failure wins: not_nfc, hyphen, combining_mark, disallowed, std3, punycode, empty_label, then domain_too_long or label_too_long. The last two are limit_exceeded. Earlier failures are invalid_input. details.reason is that code.","Input longer than 253 UTF-16 code units, or whose UTF-8 form exceeds 253 bytes, is limit_exceeded before mapping and before the lone-surrogate check."],"limits":{"max_input_bytes":253,"max_domain_octets":253,"max_label_octets":63},"pricing":{"status":"unpriced","charge_usd":null},"input_schema":{"type":"object","additionalProperties":false,"required":["domain"],"properties":{"domain":{"type":"string","minLength":1,"description":"Domain name, without a scheme or path. Omitted transitional means false."},"transitional":{"type":"boolean","description":"UTS #46 Transitional_Processing. Omission means false."}}},"output_schema":{"type":"object","additionalProperties":false,"required":["ascii","transitional","data_version"],"properties":{"transitional":{"type":"boolean"},"data_version":{"type":"string","const":"unicode-17.0.0-uts46-rev33"},"ascii":{"type":"string","minLength":1,"maxLength":253}}},"examples":[{"input":{"domain":"faß.de","transitional":true},"output":{"ascii":"fass.de","transitional":true,"data_version":"unicode-17.0.0-uts46-rev33"}},{"input":{"domain":"Bücher.de"},"output":{"ascii":"xn--bcher-kva.de","transitional":false,"data_version":"unicode-17.0.0-uts46-rev33"}},{"input":{"domain":"BLOẞ.de","transitional":true},"output":{"ascii":"bloss.de","transitional":true,"data_version":"unicode-17.0.0-uts46-rev33"}}],"execute_url":"/v1/tools/idna-domain-to-ascii/versions/1.0.0/execute"}