单独看到“179902”， ，，，，，，，不能直接判定它代表某个固定字符、功夫或业务寓意。。。。。更靠得住的做法是先保留原始字符串， ，，，，，，，再凭据起源和约定选择解码规定， ，，，，，，，最后通过接口返回候选了局、判断凭据与明确状态。。。。。若把它按十进造 Unicode 码点推算， ，，，，，，，数值对应 U+2BE BE？？？？？？正确写法为 U+2BEBE， ，，，，，，，但这只能注明一种数学转换了局， ，，，，，，，不能证明它就是原始代码的真实寓意。。。。。
因而， ，，，，，，，开发“179902解码数字时期的神秘代码”职能时， ，，，，，，，沉点不是假造一个唯一答案， ，，，，，，，而是成立可追忆的输入校验、规定选择和了局返回机造。。。。。接口应分辨“已确认”“候选诠释”和“无法判断”， ，，，，，，，预防把猜测假装成确定了局。。。。。
179902到底能不能直接解码？？？？？？
不能仅凭这一串数字实现靠得住解码。。。。。数字字符串可能来自业务编号、数据库主键、功夫戳、十进造字符码、十六进造数据或某种自界说编码。。。。。它们的表观一样， ，，，，，，，诠释方式却齐全分歧。。。。。
| 候选规定 | 对179902的处置 | 能否直接确认 |
|---|---|---|
| 业务编号 | 维持字符串179902不变 | 必要业务字段界说 |
| 十进造整数 | 解析为整数179902 | 只能确认数致粪型 |
| Unicode码点 | 换算为U+2BEBE | 还需查对字符数据库和起源约定 |
| 单字节ASCII或UTF-8 | 数值超过单字节领域 | 不能作为单个字节直接诠释 |
| 功夫戳 | 必须预言家路单元和肇始功夫 | 短缺高低文时不能判断 |
这个判断能够先转化为几个可验证前提：输入是否只蕴含数字、是否允许前导零、起源字段是什么、挪用方指定了哪种模式、服务端选取哪一版字符数据库。。。。。若是挪用方传入的是订单号， ，，，，，，，系统就不应擅自把它转换成字符；；； ；；若是挪用方明确申明是十进造码点， ，，，，，，，系统才应执行相应校验。。。。。
明确了候选寓意后， ，，，，，，，接口应该返回什么？？？？？？
若是没有现成的官方接口， ，，，，，，，能够在自己的服务中设计一个“候选解码接口”。。。。。下面的蹊径和字段是实现建议， ，，，，，，，不代表某个平台已经提供了这个接口。。。。。左券的关键是：输入、规定、候选了局和最终状态都要明确。。。。。
| 项目 | 建议约定 |
|---|---|
| 要求步骤 | POST |
| 蹊径 | /v1/decode |
| 要求体式 | JSON |
| 必填字段 | value、mode |
| 返回沉点 | normalized、candidates、selected、status |
一个自动判断要求能够写成下面的结构：
若是服务只找到十进造 Unicode 这一项候选。。。。 ，，，，，，，返回了局能够保留不确定状态：
selected为空并不是接口失败， ，，，，，，，而是服务正确表白了“存在候选、尚未确认”。。。。。只有挪用方传入明确的mode， ，，，，，，，或者服务凭据可信的字段配置实现匹配， ，，，，，，，才适合填入最终了局。。。。。
要求字段若何预防歧义？？？？？？
| 字段 | 类型 | 注明 |
|---|---|---|
| value | 字符串 | 保留原始输入， ，，，，，，，蕴含前导零 |
| mode | 枚举 | auto、decimal、unicode、hex、identifier等 |
| context | 字符串 | 注明起源， ，，，，，，，例如order_id、text_code或unknown |
| unicodeVersion | 字符串 | 执行字符查问时固定数据库版本 |
value建议始终使用字符串， ，，，，，，，而不是整数。。。。。这样能够保留“00179902」剽类可能有业务意思的输入， ，，，，，，，也能预防分歧说话在大整数解析时产生精度差距。。。。。对于mode， ，，，，，，，auto只适合返回候选。。。。 ，，，，，，，不适合强行给出唯一答案；；； ；；decimal和unicode等明确模式则应选取严格校验。。。。。
怎么把解码规定实现成可测试？？？？？？？？？？？？
实现层能够选取“规范化、规定注册、候选天生、了局裁决”四个？？？？？？椤。。。。规范化？？？？？？橹蛔龀ざ取⒆址涂杖闭绞醪槌 ，，，，，，，不扭转业务寓意；；； ；；规定？？？？？？楸鹄氪χ檬臁⑹臁nicode和业务标识符；；； ；；候选？？？？？？榧吐济扛龉娑ǖ牧司；；； ；；裁决？？？？？？槠揪菖灿梅侥Ｊ胶透叩臀木龆ㄊ欠穹祷豷elected。。。。。
- 保留原值。。。。。纪录input， ，，，，，，，同时天生normalized。。。。。除非接口左券明确允许， ，，，，，，，不然不要自动删除空格、补零或截断字符。。。。。
- 执行基础校验。。。。。空字符串返回参数谬误；；； ；；蕴含犯法字符时回绝进入数值解析；；； ；；过长输入应设置长度上限， ，，，，，，，预防无界转换。。。。。
- 按模式选择规定。。。。。mode为decimal时只接受十进造数字；；； ；；mode为hex时应明确是否要求0x前缀、是否允许奇数长度；；； ；；mode为identifier时只做体式验证， ，，，，，，，不做字符转换。。。。。
- 纪录证据。。。。。每个候选至少蕴含scheme、value、valid、confidence和reason， ，，，，，，，使前端或挪用方能够诠释了局。。。。。
- 统一裁决。。。。。只有一个规定被明确指定并通过校验时才返回selected；；； ；；auto模式下出现多个可行规定时返回ambiguous。。。。。
对于十进造 Unicode 模式， ，，，，，，，服务至少必要验证数值不超过Unicode最大码点， ，，，，，，，并排除代理区间；；； ；；数值通过领域校验， ，，，，，，，也不蹬宗该码点肯定已经分配了可显示字符。。。。。若产品要求显示字符， ，，，，，，，还要凭据固定版本的Unicode数据判断是否已分配、是否为节造字符， ，，，，，，，以及客户端字体是否支持。。。。。
对于UTF-8， ，，，，，，，不能把179902直接当成一个字节。。。。。若输入现实代表十六进造字节串， ，，，，，，，应先依照字节天堑拆分， ，，，，，，，再执行UTF-8齐全性校验；；； ；；若输入是一个业务编号， ，，，，，，，则应终场在标识符模式， ，，，，，，，不要为了“得到了局”持续尝试字符转换。。。。。
哪些返回状态适合接入前端和其他服务？？？？？？
| HTTP状态 | 业务状态 | 使用场景 |
|---|---|---|
| 200 | decoded | 指定规定成功实现解码 |
| 200 | ambiguous | 有多个候选。。。。 ，，，，，，，临时不能选定 |
| 400 | invalid_request | 短缺value或mode体式谬误 |
| 422 | unsupported_value | 体式正确， ，，，，，，，但不切合指定规定 |
例如， ，，，，，，，mode为decimal且value为179902时， ，，，，，，，能够返回整数了局；；； ；；mode为unicode时， ，，，，，，，能够返回U+2BEBE及其字符数据库校验了局；；； ；；mode为identifier时， ，，，，，，，则应返回原字符串和体式验证了局。。。。。三种响应都合理， ，，，，，，，关键在于它们别离对应分歧的接口左券， ，，，，，，，而不是由服务端擅自替用户选择。。。。。
上线前怎么验证179902的解码了局？？？？？？
测试应覆盖输入天堑和规定天堑， ，，，，，，，而不只是验证一个成功案例。。。。。至少能够筹备以下用例：
- 179902 + decimal：应得到整数179902。。。。。
- 179902 + unicode：应得到候选码点U+2BEBE， ，，，，，，，并返回字符分配状态。。。。。
- 179902 + identifier：应保留原字符串， ，，，，，，，不进行字符转换。。。。。
- 00179902 + identifier：前导零必须保留。。。。。
- 空值或仅空格：返回invalid_request。。。。。
- 179902a + decimal：返回unsupported_value或参数校验谬误。。。。。
- mode为auto：存在多个候选时返回ambiguous， ，，，，，，，而不是随机选择。。。。。
最终， ，，，，，，，179902的靠得住解码蹊径不是“看到数字就给出一个神秘答案”， ，，，，，，，而是从原始输入起头， ，，，，，，，明确规定、校验领域、返回证据并保留不确定性。。。。。这样设计后， ，，，，，，，接口既能处置当前数字， ，，，，，，，也能扩大到其他编码值， ，，，，，，，同时不会把业务编号、字符码和功夫数据混为一谈。。。。。
Android版
iPhone版