电话号码智能查询。线路类型、运营商、携号转网来源、欺诈信号。
支持 MNP 的运营商查询，与 Bird 的 SMS 和语音流量共享同一网络线路。一个端点、相同的认证方式、与所有其他 Bird 通道一致的错误格式——因为它们都由同一个工程团队构建。
从 npm install 到首次查询仅需5分钟
用您已经在使用的编程语言查询号码。
覆盖所有主流运行时的 SDK。查询中位响应时间低于 300 毫秒，快到足以在 SMS 发送前完成拦截判断。
此 API 上线后将提供代码示例。SDK 已覆盖现有频道。
十个数据字段，否则您需要从三家供应商分别拼凑。
具体的数据点，命名明确、可审计。每一条都来自真实数据源，而非模型猜测。
- 01
线路类型检测
移动电话、固定电话、VoIP、免费电话、增值电话、寻呼机。在发送前判断该号码是否支持 SMS。
- 02
运营商识别
根据 E.164 格式输入返回当前运营商名称和国家代码。持续对照 MNP 注册数据库更新。
- 03
携号转网历史
该号码此前从哪家运营商转出。可用于路由成本预测和欺诈启发式分析。
- 04
国家和地区格式
返回 E.164、国内和国际格式；路由器所需的国家和地区代码。
- 05
欺诈信号
每个号码返回 0-1 的 fraud_score，综合速率、线路类型启发式、近期携号转网标记和已知恶意名单。
- 06
有效性和可达性
一个布尔值 valid 和一个可达窗口：有些号码格式解析正常，但运营商已不再分配它们。
- 07
批量查询
一次调用中 POST 最多 1,000 个号码。按相同的单号定价计费，节省往返请求开销。
- 08
缓存感知定价
相同输入在 24 小时内的缓存查询免费。只有当结果确实不同时才会计费。
- 09
批量任务 Webhook
对于大批量任务，订阅 lookup.completed 事件并读取结果文件，无需保持 HTTP 长连接。
- 10
相同的认证，相同的错误响应格式
一个 API 密钥通用于 Lookup、SMS、Email、WhatsApp、Voice。统一的错误类型注册表。
我们为什么构建 Lookup
您不应该在 SMS 发送失败后才发现那是个固定电话号码。
我们在 Bird SMS 路由内部已经运行 MNP 查询——这是必须的，以便实时选择最低成本的运营商路由。Lookup 就是同一个查询，作为一级端点对外开放，让您无需发送任何一条 SMS，即可拦截注册、评估风险并预估路由成本。与平台其他功能共享相同的认证方式、错误格式和 Webhook。
每次状态变更都是一个 Webhook。
HMAC 签名的载荷，防重放，幂等。单号查询为同步返回；批量查询以 Webhook 方式分发。
重试计划：5 秒、30 秒、5 分钟、30 分钟、2 小时、6 小时、12 小时。最终尝试后进入死信队列；每个死信事件均可从控制台或 API 重放。
lookup.completed查询（单个或批量）已完成。载荷包含完整响应。lookup.failed查询无法执行；载荷包含错误响应信息。
先查询号码，再发送消息。
相同的认证方式、相同的幂等性契约、相同的错误格式。Lookup 的结构与其他端点一致，区别仅在于它返回数据而非发送消息。
Lookup。
运营商、线路类型、携号转网来源、欺诈信号：同步返回，响应时间低于 300 毫秒。
SMS。
相同的认证方式、相同的错误格式。根据查询结果决定是否发送：在产生费用之前过滤掉固定电话号码。