验证电话号码，检查运营商和线路类型。

别再为向固定电话或失效号码发送 SMS 付费。一次调用即可检查电话号码的国家/地区、当前服务运营商、原始网络和线路类型；在验证高风险操作时，还可加入携号转网、实时网络在线状态或 SIM 卡更换信号。

开始使用联系销售

+31612345678

POST/v1/lookup/phone-number

有效号码

号码详情

国家/地区

荷兰

线路类型

移动

服务运营商

Vodafone·20404·已携号转网

发行运营商

KPN·20408

国家/地区

荷兰

线路类型

移动

服务运营商

Vodafone·20404·已携号转网

发行运营商

KPN·20408

响应正文

200

{
  "phone_number": "+31612345678",
  "country_code": "NL",
  "network_info": {
    "carrier_name": "Vodafone",
    "mcc": "204",
    "mnc": "04"
  },
  "original_network_info": {
    "carrier_name": "KPN",
    "mcc": "204",
    "mnc": "08"
  },
  "flags": ["ported"],
  "line_type": "mobile"
}

基于响应结果的建议下一步读取国家和服务网络，然后查看每个请求属性的返回状态。准备收件人核验该号码是带有网络信息的移动线路。授予账户访问权限前，请另行验证收件人是否掌控该号码。下一步：验证收件人请提供国家代码不会根据本地号码猜测所属国家。请先更正输入，再进行下一次查询。下一步：确认完整号码准备收件人核验该号码是带有网络信息的移动线路。授予账户访问权限前，请另行验证收件人是否掌控该号码。下一步：验证收件人请提供国家代码不会根据本地号码猜测所属国家。请先更正输入，再进行下一次查询。下一步：确认完整号码准备收件人核验该号码是带有网络信息的移动线路。授予账户访问权限前，请另行验证收件人是否掌控该号码。下一步：验证收件人

一次基础查询，无需附加属性。

查看基础记录，以及当前服务网络与原始号码分配网络之间的区别。

了解电话号码查询

检查号码基础记录，
并加入实时网络信号。

在注册或结账时验证电话号码，并在风险较高时请求更深入的运营商检查。

了解电话号码查询

避免国家/地区匹配不明确。

传入号码时需带国家/地区区号，并以加号或 00 作为前缀。Bird 会拒绝缺少国家/地区区号的国内格式号码，以免含义不明确的输入意外解析为另一个国家/地区的有效用户。

按运营商和线路类型路由。

基础查询在一次响应中返回当前服务运营商、原始发号网络、线路类型和国家/地区。发送 SMS 前可过滤掉固定电话；客户提供固话号码时，可改用语音呼叫。

重试时避免重复查询计费。

当注册或结账服务在网络超时后重试时，请在查询请求中附带幂等键，这样 Bird 会返回缓存结果，而不会再次向你的工作区计费。

规模扩展
不失控。

在工作区中组织团队，控制 API 访问权限，通过审计日志追踪变更。

组织

Harbor

生产环境

沙盒环境

访问权限仅限于其所在工作区。

生产环境/API 密钥

注册服务

活跃

邮件

SMS

Lookup

Alex Lee

管理员

更改已保存

今天 · UTC

审计日志

API 密钥已更新Alex Lee · 生产环境

09:42:18无写入

API 密钥已创建Alex Lee · 生产环境

09:41:06

已邀请成员Alex Lee · 沙盒环境

09:38:24

工作区已创建Alex Lee · 沙盒环境

09:36:02

已邀请成员Alex Lee · 生产环境

09:31:47

工作区团队角色 API 身份验证

了解企业方案

从 Lookup 开始。
使用 Bird 跨渠道构建。

开始使用联系销售

验证电话号码， 检查运营商和线路类型。

检查号码基础记录，并加入实时网络信号。

避免国家/地区匹配不明确。

按运营商和线路类型路由。

重试时避免重复查询计费。

继续构建使用 Lookup。

线路类型

运营商查询

网络在线状态

规模扩展 不失控。

从 Lookup 开始。使用 Bird 跨渠道构建。

Start building with Bird in minutes.

验证电话号码，检查运营商和线路类型。

检查号码基础记录，
并加入实时网络信号。

继续构建
使用 Lookup。

规模扩展
不失控。

从 Lookup 开始。
使用 Bird 跨渠道构建。