CarrierLookup 如何验证手机号

完成一次检测

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

1. 1

   提交手机号

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

2. 2

   使用 service_type=carrier

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

3. 3

   读取结果

   在同一个响应中读取 extra 对象；需要最新数据时重新查询。

提交手机号要用什么格式

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

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

extra 对象代表什么？

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

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

结果的使用边界

检测结果反映请求时的状态，不是身份认证或联系许可。

• 不能据此确认手机号所有者；它也不跟踪携号转网 —— 已转网的号码返回的仍是其号段最初分配到的运营商。
• 运营商结果不代表已取得联系该号码的同意。
• 业务需要最新状态时，应重新发起检测。

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

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

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