推送状态报告
1 协议说明
协议 | HTTP POST |
---|---|
编码格式 | UTF8 |
URL | 举例:http://somedomain.com/sms/smscallback(需客户开发) |
接口说明 | 短信下发给用户后,云大师短信服务可以通过回调url的方式,通知客户方短信下发的状态。 |
2 请求包体
[
{
"user_receive_time": "2015-10-17 08:03:04", //用户实际接收到短信的时间
"nationcode": "86", //国家码
"mobile": "13xxxxxxxxx", //手机号码
"report_status": "SUCCESS", //实际是否收到短信接收状态。SUCCESS(成功)FAIL(失败)
"errmsg": "DELIVRD", //用户接收短信状态码
"description": "用户短信送达成功", //用户接收短信状态描述
"sid": "xxxxxxx" //标识本次发送id
}
]
参数 | 必选 | 类型 | 描述 |
---|---|---|---|
user_receive_time | 是 | string | 用户实际接收到短信的时间 |
nationcode | 是 | string | 国家码 |
mobile | 是 | string | 手机号码 |
report_status | 是 | string | 实际是否收到短信接收状态,SUCCESS(成功)、FAIL(失败) |
errmsg | 是 | string | 用户接收短信状态码错误信息,参考 状态回执错误码 |
description | 是 | string | 用户接收短信状态描述 |
sid | 是 | string | 本次发送标识 id |
注
1、一次回调请求里可能有多次的短信请求结果
2、"errmsg"详见请联系云大师工作人员
3 应答包体
第三方业务收到回调请求下,需要按以下的格式给云大师短信业务应答
{
"result": 0, //0表示成功,非0表示失败
"errmsg": "OK" //result非0时的具体错误信息
}