短信通知接口
接口功能
隐私保护通话平台通过此接口向客户服务器推送隐私号短信通知。
通知模式为Notify模式，客户收到通知后返回HTTP状态码为200的空消息即可。
AXB模式发送小号短信的流程如下：
A或B发送短信给X，隐私保护通话平台将短信转发给绑定关系的另一方（发送方号码是X），并推送Notify模式的小号短信通知给客户服务器。
请求方向
隐私保护通话平台（客户端） → 客户服务器（服务端）
使用说明
前提条件
- 客户添加应用时需设置短信通知接收地址，并确保提供的地址能够正常处理隐私保护通话平台发送的通知消息。
- 若需要接收用户发送的短信内容，请参考如何设置才能收到短信内容？进行设置。
- 如果需要开启短信事件通知重传功能，需提前向系统管理员申请。该功能开启后，当隐私保护通话平台推送短信事件通知给客户服务器失败时，隐私保护通话平台会重传事件通知给客户服务器。最多重传6次，每次重传时间间隔可由系统管理员设置。
接口类型
请求方法 |
POST |
|---|---|
访问URI |
客户添加应用时填写的短信通知地址 |
通信协议 |
HTTPS |
请求参数
参数名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
appKey |
是 |
String(1-32) |
隐私保护通话应用的APP_Key。 |
smsEvent |
是 |
短信状态事件。 |
参数名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
smsIdentifier |
是 |
String(1-64) |
短信唯一标识。 若用户发送的是长短信，隐私保护通话平台会将长短信的多个分片合并为一个通知上报。 |
notificationMode |
是 |
String(1-8) |
通知模式： Notify：通知模式。 |
calling |
否 |
String(1-32) |
真实发送方号码。 号码为全局号码格式（包含国家码），比如+8613866887021。 |
called |
否 |
String(1-32) |
真实接收方号码。 仅在隐私保护通话平台转发短信成功后携带。 号码为全局号码格式（包含国家码），比如+8613866887022。 |
virtualNumber |
否 |
String(1-32) |
X号码。 号码为全局号码格式（包含国家码），比如+8613800000001。 |
event |
是 |
String(1-16) |
短信状态事件。 TextSMS：文本短信 |
timeStamp |
是 |
String(1-32) |
短信事件发生的系统时间戳，UTC时间。 格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z' 其中SSS是毫秒，“T”和“Z”为固定字符。 |
extInfo |
是 |
拓展信息。 |
|
subscriptionId |
否 |
String(1-64) |
绑定ID。 |
smsContent |
否 |
String(1-2000) |
用户发送的短信内容。 请参考如何设置才能收到短信内容？开通该功能。 |
sendResult |
是 |
Integer |
发送结果。
|
参数名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
extParas |
是 |
JsonArray |
扩展信息(Key-Value)列表。 格式如下： "extParas": [{"key": "splitNum","value": "value1"},{"key": "direction","value": "value2"}] Key、Value取值分别不能超过32个字节。 “key”取值为“splitNum”时表示实际短信发送成功数量，即长短信拆分后的短信数量。value1表示“splitNum”的取值。 “key”取值为“direction”时表示短信发送方向。value2表示“direction”取值，含义如下：
|
响应参数
客户服务器接收到隐私保护通话平台Notify模式的短信事件通知后，返回无消息体的200响应。
接口示例
接口示例仅供参考，请以实际消息为准。
- 请求示例
POST /notify HTTP/1.1 Content-Type: application/json;charset=UTF-8 { "appKey":"S368k6Y31w4kNuI6X1gsne5n09gA", "smsEvent":{"smsIdentifier":"3db91cc30dd641eaa0ce57ca7596d49c", "notificationMode":"Notify", "calling":"+8613800000001", "virtualNumber":"+8613800000000", "event":"TextSMS", "timeStamp":"2020-12-23T09:06:16.450Z", "extInfo":{"extParas":[{"key":"splitNum","value":"0"},{"key":"direction","value":"2"}]}, "sendResult":2} } } - 响应示例
HTTP/1.1 200 OK
