用途:通过 Sinch Number Lookup API 查询单个电话号码的详细信息,用于反欺诈、消息路由和数据丰富。主要能力包括运营商名称、线路类型(Landline、Mobile、VoIP 等)、携号转网状态与日期、SIM 卡更换检测、VoIP 检测(alpha)以及号码重新分配检测(alpha)。
使用方式:基础地址为 https://lookup.api.sinch.com,端点为 POST /v2/projects/{PROJECT_ID}/lookups,使用 Bearer 令牌认证。请求体需指定 E.164 格式号码,features 数组可选 LineType(默认)、SimSwap、VoIPDetection、RND;请求 RND 时必须提供 rndFeatureOptions.contactDate(YYYY-MM-DD)。凭据应通过环境变量提供,例如 SINCH_PROJECT_ID、SINCH_ACCESS_TOKEN 等。
适用场景:发送验证码前的欺诈检查、发送前的号码清洗与路由、结合验证流程选择短信或语音通道。
限制:无批量端点,多号码需并行请求;features 省略时仅返回 LineType;VoIP 概率为字符串枚举而非数值;SIM 卡更换依赖运营商支持;VoIPDetection 与 RND 为 alpha;可能触发 429 限流;402 表示账户锁定,403 表示项目未启用该 API。号码属于 PII,需谨慎记录。具体字段与枚举应以官方文档为准。