短信状态推送接口
典型场景
平台下发短信后，将运营商网关推送给我们的下发内容状态推送给用户。
接口功能
便于用户能实时接收到下发短信后回应给运营商网关的状态。
变更记录
|
接口版本 |
更新时间 |
更新人 |
更新说明 |
|---|---|---|---|
1.0.0 |
2019-04-25 |
张云 |
新增短信状态推送接口文档示例 |
1.0.1 |
2020-10-20 |
杨康 |
优化 驼峰命名参数修改 messageid -> messageId submitstate -> submitState |
1.0.2 |
2020-10-20 |
杨康 |
新增响应时间参数 reportTime |
注意事项
* 用户成功收到平台推送的状态之后，返回 0 ;
只有在用户成功返回0之后系统才认为本次推送用户已经成功接收，否则认为推送失败
接口原型
|
推送类型 |
POST |
|---|---|
|
接口地址 |
用户提供接口地址，平台 -> 短信管理 -> 短信记录 -> 状态/回复推送地址设置 |
|
传输协议 |
HTTP/HTTPS |
|
接口说明 |
将网关推送的状态推送给用户 |
推送示例
{"iccid":"89860328050000159606","msisdn":"1064962589269","messageId":"201809111532482262857","content":"123","submitState":"DELIVRD","remark":"指令设置成功","reportTime":"2020-10-20 12:12:12"}
推送参数
Content-Type:application/json
Body:
{
"iccid": "******",
"msisdn": "******",
"messageId": "******",
"content": "******",
"submitState": "******",
"remark": "******",
"reportTime": "******",
}
|
参数 |
类型 |
描述 |
|---|---|---|
|
iccid |
String |
iccid |
|
msisdn |
String |
卡号 |
|
messageId |
String |
消息id |
|
content |
String |
指令内容 |
|
submitState |
String |
状态代码 |
|
remark |
String |
响应消息 |
|
reportTime |
String |
响应时间 |
响应示例
0
