SMSPVA / DOCUMENTATION
短信、来电显示与语音
理解 voice 参数、权限规则和结果格式。
SMSPVA API
下单前选择类型
voice 查询值 | 结果 |
|---|---|
| 0 | 短信,默认 |
| 1 | 来电显示 |
| 2 | 语音电话 |
支持此参数的价格接口与号码申请应使用相同类型。接收短信只使用订单 ID,不需要 voice。
权限规则
消息类型设置返回 country、service、operator 条件。空条件不限制匹配。非空匹配条件越多,规则优先级越高。应一起使用对应规则的三个标志;没有匹配规则时,三种类型默认均启用。
规则中的 sms、caller、voice 均使用 1 表示启用、0 表示禁用,不能与查询参数 voice=0/1/2 混淆。权限允许不代表存在可用号码。
结果格式
三种类型使用相同 JSON 结构。供应商 text 原样映射到 data.sms.code,sms 原样映射到 data.sms.fullText。
code 不保证是数字验证码。语音结果可能包含文字及录音链接。原文档中有些格式仅为示例或尚未确认,这些限定保留在响应示例中。来电显示使用占位符,因为供应商具体格式尚未确认。
三种类型均使用 202 / SMS_NOT_YET_RECEIVED 表示等待。参见轮询指南。