CarrierLookup 如何验证号码

完成一次检测

这一节讲同步实时检测：SaaS 网页后台与 REST API 的同步接口使用同一套检测服务和响应含义。名单非常大时另有异步批量任务，见文末。

1. 1

   提交号码

   按 API 文档提交一个完整的号码。

2. 2

   使用 service_type=carrier

   carrier 产品返回号码最初被分配到的网络，并带线路类型与归属地区。

3. 3

   读取结果

   在同一个响应中读取运营商字段；它们描述的是原始分配，而不是当前为该号码提供服务的运营商。

提交号码要用什么格式

CarrierLookup 每次查询接受一个号码，须为 E.164 格式：加号、国家码，然后是用户号码，中间不带空格或分隔符。

• 提交完整号码，必须带国家码：不带国家码的国内号码无法查询。
• 不接受带前导零、空格、横线或括号的国内格式 —— 只发送加号和数字。
• 格式不对的号码会在扣费前被拒绝；格式被拒不是「无结果」。

运营商字段代表什么？

运营商字段就是运营商查询的答案：carrier、underlying_carrier、number_type、country_code、region、city，平铺在成功响应的顶层。内容包括最初分配的运营商与线路类型、国家，上游给了还会有归属地区和城市。没有 registered 字段 —— 成功返回本身就是结果。其它情况 —— 超时、无法判定、号码非法 —— 会以错误码返回，并自动退款。某个字段为空不代表「没有运营商」，只代表上游没有提供这一项。

• carrier 是号码在号段分配时所属的网络。
• 上游未提供时，number_type、region、city 可能为空字符串，但键始终存在。
• 其他情况请根据 API 返回的 code 处理，不要自行推断分配信息。

结果的使用边界

运营商结果描述的是号码最初被分配到的网络，不是可达性检测、身份认证或联系许可。

• 不能据此确认号码所有者；它也不跟踪携号转网 —— 已转网的号码返回的仍是其号段最初分配到的运营商。
• 运营商结果不代表已取得联系该号码的同意。
• 不要把结果当作当前运营商：重新查询返回的仍是同一个原始分配，而不是号码可能已转入的网络。

名单非常大时：异步批量选项

网页多号检测与 API 多号接口覆盖绝大多数名单。只有名单远超这些上限时，才值得把整份文件作为一个异步批量任务提交。

• 在批量检测页或通过 API 上传 .txt / .csv，一行一个号码。
• 上传时选定号码所属国家；每一行仍建议写成 E.164 格式。
• 提交时按有效行数冻结相应余额，只对实际返回结果的号码计费，差额自动退回。
• 任务在后台执行，完成后下载结果文件；失败则全额退款。