输入指南

如何将手机号规范为 E.164 格式

E.164 是 TG Validator 请求使用的国际手机号格式。规范号码以 + 开头,包含国家或地区调用代码,之后只有数字,不包含空格、括号、连字符或仅供国内拨号使用的长途冠码。

审核日期:2026 年 7 月 21 日

有效的 E.164 输入是什么样?

使用 +、国家或地区调用代码和用户号码,且不包含空格或标点,例如 +14155552671。不要在未处理的本地号码前直接添加国家代码;应先按该国家编号规则移除展示符号和仅供国内使用的长途冠码。

验证前先规范化号码

保留原始值用于审计,再生成一个统一号码用于匹配和 API 请求。

  1. 1

    确定国家或地区

    使用明确国家字段或可靠来源信息,不要从有歧义的本地号码猜测。

  2. 2

    移除展示符号

    删除空格、连字符、括号和点号,它们不属于规范号码。

  3. 3

    应用当地编号规则

    仅在该国家国际格式要求时移除国内长途冠码。

  4. 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 输入检查清单

请求前确认号码唯一规范,并能追溯回导入记录。

  • 号码以 + 开头,之后只有数字。
  • 调用代码来自明确或可靠的国家上下文。
  • 本地号码已按对应国家规则转换。
  • 去重使用规范号码。
  • 原始输入仍可用于复核。

权威来源