输入指南
如何将手机号规范为 E.164 格式
E.164 是 TG Validator 请求使用的国际手机号格式。规范号码以 + 开头,包含国家或地区调用代码,之后只有数字,不包含空格、括号、连字符或仅供国内拨号使用的长途冠码。
审核日期:2026 年 7 月 21 日
有效的 E.164 输入是什么样?
使用 +、国家或地区调用代码和用户号码,且不包含空格或标点,例如 +14155552671。不要在未处理的本地号码前直接添加国家代码;应先按该国家编号规则移除展示符号和仅供国内使用的长途冠码。
验证前先规范化号码
保留原始值用于审计,再生成一个统一号码用于匹配和 API 请求。
- 1
确定国家或地区
使用明确国家字段或可靠来源信息,不要从有歧义的本地号码猜测。
- 2
移除展示符号
删除空格、连字符、括号和点号,它们不属于规范号码。
- 3
应用当地编号规则
仅在该国家国际格式要求时移除国内长途冠码。
- 4
添加 + 与调用代码
在发送 service_type=tg 前校验最终规范字符串。
常见输入与修正示例
这些实例展示常见转换模式,不能替代持续更新的号码规则库。
| 原始输入 | 规范示例 | 原因 |
|---|---|---|
| +1 (415) 555-2671 | +14155552671 | 保留调用代码 1 并移除标点。 |
| 415-555-2671,国家=US | +14155552671 | 先使用明确国家上下文再添加调用代码。 |
| 0044 20 7946 0958 | +442079460958 | 把国际接入前缀 00 转换为 +。 |
| +44 (0)20 7946 0958 | +442079460958 | 国际格式不保留国内长途冠码 0。 |
| 14155552671 | 需要国家上下文 | 没有 + 时,未约定国家的纯数字号码存在歧义。 |
格式正确不代表已注册 Telegram、属于预期用户、可联系或已取得同意。
拒绝有歧义的转换
规范化应统一已知信息,而不是补造缺失的国家或编号信息。
- 没有国家规则时不要随意删除开头数字。
- 不要认为 +、00 与本地开头的 0 在所有国家都能直接互换。
- 按规范值识别重复记录,同时保留每条来源数据。
- 将有歧义的号码送去纠错,不要重复猜测并请求。
API 输入检查清单
请求前确认号码唯一规范,并能追溯回导入记录。
- 号码以 + 开头,之后只有数字。
- 调用代码来自明确或可靠的国家上下文。
- 本地号码已按对应国家规则转换。
- 去重使用规范号码。
- 原始输入仍可用于复核。