注册并联系客服,免费领取 100 次检测。免费注册
CarrierLookup 工作流示意图:E.164 格式电话号码:如何为原始归属运营商查询设置号码格式
本文所述工作流的示意图(CarrierLookup)。

本指南介绍了如何编写 E.164 格式的电话号码、转换本地格式,以及为 CarrierLookup 准备实时查询和文件输入。

E.164 格式的电话号码以加号(+)开头,后跟国家代码和用户号码,中间不含空格、短横线或括号,例如 +442071838750。根据国际标准,E.164 格式的号码总长度上限为 15 位。在进行原始归属运营商查询前,请务必先将所有本地号码转换为此格式,并去掉任何国家长途前缀(例如开头的零)。CarrierLookup 的实时查询要求号码以加号开头。批量文件行则使用不带加号的纯数字,每行一个号码。因格式问题被拒绝的号码属于格式错误,需要修正,而非“无法判定”结果。

E.164 格式的含义

E.164 是由 ITU 发布的国际编号计划。该计划下的号码最多包含三个部分:一到三位的国家代码、国家目的码以及用户号码。书写时,它表现为加号后紧跟数字。总长度上限为 15 位。

加号是国际呼叫前缀的符号。由于从固定电话或手机拨打国际电话的前缀因国家/地区而异,因此标准中使用加号代替特定的前缀。

部分 示例 说明
加号 + 始终位于首位
国家代码 44 一到三位数字
国家号码 2071838750 不含长途前缀
结果 +442071838750 无空格或分隔符

请将 E.164 作为电话号码的唯一存储格式。括号和空格等显示格式仅适用于用户界面,属于展示层,不应包含在发送给查询服务的字段中。

逐步转换本地格式

大多数不规范的电话号码列通常遵循几种模式。请按以下顺序进行处理:

  1. 移除所有非数字和非首位加号的字符。 空格、点号、短横线和括号均需移除。
  2. 替换首位国际拨号前缀。 以 00 开头并后跟国家代码的号码,应转换为以加号开头并后跟国家代码的格式。
  3. 去掉国家长途前缀。 许多国家在书写本地号码时会加上一个不属于国际号码部分的开头的零。例如,英国手机号 07911 123456 应转换为 +447911123456;而美国号码 (212) 555-0123 在加上国家代码 1 后应转换为 +12125550123。
  4. 在缺失时添加国家代码。 仅当您能从账单地址或联系人来源表单等其他字段确定国家时,才执行此操作。盲目猜测国家会导致后续无法察觉的错误。
  5. 检查长度。 结果为空或长度超过 15 位的号码需要人工复核,而非直接查询。

您可以将此过程编写为可重复执行的脚本或电子表格公式,并将原始值保留在单独的列中,以便核查任何看起来异常的转换结果。

实时输入与批量文件行

CarrierLookup 接受两种输入方式,它们不可互换。

对于实时查询,请发送 E.164 格式且带有首位加号的号码。单次查询使用 POST /api/v1/check,同步多号码请求使用 POST /api/v1/batch-check。实时查询无需单独选择国家,因此一个多号码请求可以包含来自不同国家的号码。

对于批量文件任务,请创建每行一个号码的 TXT 或 CSV 文件,且不要包含标题行。每一行应包含纯数字形式的国家代码,并在提交任务时选择对应的国家。结果文件也会以不带加号的纯数字形式报告标识符,因此若要将其与您带有加号的主列关联,需要进行一次标准化步骤。

一个实用的规则是:维护一个单一的 E.164 主列,并通过去掉加号来生成文件版本。这样可以保持两条路径的一致性,避免同一号码出现两个数据源。

为什么被拒绝的格式不是“无法判定”结果

当号码格式无法被查询服务解析时,它会被拒绝。这并不代表号码本身有问题。许多团队将拒绝视为最终结论并删除行,这会导致丢失有效的联系人。

请在您的流程中区分以下三种结果:

  • 格式被拒绝。 使用上述步骤修正号码并重新提交。
  • 查询完成但字段为空。 查询已完成,但部分值不可用。请保留该行,并将空值存储为“无法判定”。
  • 查询失败或无法判定。 未产生结果,且不扣除费用。请稍后重试或将该行放入复核队列。

在批量处理路径中,预处理还会排除无效、重复、缺少国家代码或超出所选国家范围的行。被排除的行不会被扣费,保留被排除行的日志有助于您了解清理流程中哪些环节需要改进。

常见格式错误

大多数格式问题源于以下习惯:

  • 在国家代码后保留长途零。 +4407911123456 是错误的。零仅属于本地格式。
  • 在同一列中混用分隔符。 应用统一的规则远胜于处理十几种例外情况。
  • 在电子表格中将号码视为数值单元格。 这会导致首位的加号和零消失。请将该列存储为文本格式。
  • 共享国家代码。 多个国家共享 +1,因此仅凭代码无法识别具体国家。对于文件任务,请选择与列表匹配的国家。
  • 对纯本地号码猜测国家。 请使用其他可信字段,或将该行剔除。

转换完成后,请手动抽查几十行数据并对照国家编号计划进行核对,然后再运行完整列表。请记住,格式正确的号码仅代表格式无误。随后的原始归属运营商查询结果报告的是号码的原始分配背景,而非当前运营商或可达性。

常见问题解答

团队如何将本地号码转换为 E.164 格式?

去掉所有空格和分隔符,删除国家长途前缀(如开头的零),并在前面加上加号和国家代码。仅当有其他可信字段能确定国家时,才添加国家代码。请在单独的列中保留原始值以备审计。

团队如何为批量文件任务准备号码?

在 TXT 或 CSV 文件中每行写入一个号码,使用包含国家代码的纯数字格式,且不要加号,然后选择与列表匹配的国家。无效、重复或超出所选国家范围的行会在预处理阶段被排除,且不会被扣费。

团队应如何处理原始归属运营商查询中被拒绝的号码?

将其视为格式问题处理。检查加号、国家代码、长途前缀和长度,修正号码后重新提交。拒绝并不代表“无法判定”结果,因此请保留该联系人,不要将其删除。

了解更多

根据您的工作流程需求选择相应的产品信息。

参考来源