SuperAPI AI 工具集

sinch-numbers-api

编程与开发

查看项目

更新于 10-16 09:29

技能介绍

用途:Sinch Numbers API 用于搜索、激活、管理和释放电话号码,是使用 SMS、Voice 与 Conversation API 的前置条件。既可操作当前已租号码(activeNumbers),也可搜索可租号码(availableNumbers)。

主要能力:按区域与号码类型(LOCAL、MOBILE、TOLL_FREE)搜索号码;租用单个号码或使用 rentAny(仅限美国 LOCAL);更新 displayName、SMS 与语音配置;释放号码;管理紧急地址;在受 KYC 管制地区使用 numberOrders 流程;通过独立接口导入非 Sinch 号码。可用 GET /availableRegions 查询有效区域码。

使用方式:可选用 SDK(@sinch/sdk-core、sinch、com.sinch.sdk)或直接 API。先按 sinch-authentication 完成鉴权,再验证连通性:curl -X GET "https://numbers.api.sinch.com/v1/projects/$SINCH_PROJECT_ID/activeNumbers?regionCode=US&type=LOCAL&pageSize=10" -H "Authorization: Bearer $SINCH_ACCESS_TOKEN" -H "Content-Type: application/json"。搜索租用流程为 GET /availableRegions、GET /availableNumbers、POST /availableNumbers/{phoneNumber}:rent、GET /activeNumbers/{phoneNumber} 确认。获取全部号码可运行 node scripts/get_numbers.cjs --output numbers.json。

限制与注意事项:type 默认 MOBILE,省略只会返回 MOBILE;GET /activeNumbers 需显式设置 pageSize;availableNumbers 使用 capabilities/size,activeNumbers 使用 capability/pageSize。计费操作(rent、rentAny、release)响应不确定时不得盲目重试,应先通过读取接口核验状态。campaignId 仅美国 10DLC 需要;解除关联需在 servicePlanId 或 campaignId 传空字符串;重新关联前须先解绑。voiceConfiguration 为按 type 区分的联合类型(RTC 用 appId、EST 用 trunkId、FAX 用 serviceId)。回调配置仅设置 hmacSecret 用于 HMAC-SHA1 签名校验,不设置回调 URL,回调 IP 允许列表为 54.76.19.159、54.78.194.39、54.155.83.128。API 密钥与 hmacSecret 不得暴露于客户端或日志。仅从可信一方域名抓取 URL。更多细节见官方 Numbers API 文档与参考。