用途:Number Lookup API 用于查询电话号码的归属运营商、线路类型、携号转网状态、SIM 卡更换、VoIP 检测以及号码重分配(RND),常见于欺诈防范、消息路由与数据补全场景。接口一次只处理一个号码,没有批量端点,多号码需自行并行请求。
主要能力:线路信息包含 carrier、type(Landline、Mobile、VoIP、Special、Freephone、Other)、MCC/MNC、ported 与 portingDate;simSwap 返回 swapped 与 swapPeriod;voIPDetection 返回 probability(Unknown、Low、Likely、High,为字符串枚举而非数值);rnd 返回 disconnected。每个特性各有独立 error 子对象,允许部分失败。
使用方式:基础地址为 https://lookup.api.sinch.com,端点为 POST /v2/projects/{PROJECT_ID}/lookups。使用 Bearer 令牌认证,凭据应通过环境变量提供,例如 SINCH_PROJECT_ID、SINCH_KEY_ID、SINCH_KEY_SECRET、SINCH_ACCESS_TOKEN。可选 SDK(Node.js、Python 为部分支持)或直接 HTTP 调用,Java 与 .NET 需使用直接 HTTP。请求体包含 number(必填,E.164 格式带 + 前缀)与 features 数组;features 省略时仅返回 LineType,SimSwap、VoIPDetection、RND 必须显式请求。请求 RND 时必须提供 rndFeatureOptions.contactDate(YYYY-MM-DD),否则返回 400。
限制:VoIPDetection 与 RND 为 alpha 特性,行为可能变化;SIM swap 依赖运营商支持,并非所有号码或地区可用;存在速率限制,超限返回 429;402 表示账户被锁定,403 表示项目未启用该 API。电话号码属于个人数据,SIM swap 与 RND 结果属于欺诈信号,不应直接返回给终端用户,日志中应做脱敏处理。凭据不得硬编码或暴露在客户端代码、日志与已提交源码中。仅应访问受信任的一手域名(如 developers.sinch.com、dashboard.sinch.com)。
关于具体价格、套餐层级与配额等事实,当前资料暂未提供。