上行报告推送
提供推送回调URL
- 客户需要提供上行短信推送的URL。
推送方式
- content-type : application/json;charset=UTF-8
- POST
- raw方式
推送参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
status | 是 | int | 上行响应状态 |
result | 是 | JSON Array | 上行回复内容(打包数组) |
result参数说明
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
phone | 是 | string | 手机号码 |
extCode | 是 | string | 用户提交短信时候带的extCode |
content | 是 | string | 上行内容 |
receivetime | 是 | string | 短信到达时间 |
推送示例
{
"status" : 0, // 固定值0
"result":
[
{
"phone" : "13921350591", // 手机号码
"extCode" : "682", // 用户提交短信时候带的extCode
"content" : "上行回复内容" , // 上行内容
"receivetime" : "20170816153922" // 短信到达时间 格式yyyyMMddHHmmss
}
// 这里是数组会有多条,默认最大100条
]
}
响应示例
0
注意事项
- 每个账号最大推送频率为10次/秒,每次推送包含最小1个、最大100个上行报告
- 客户处理数据过后必须返回数字0(不是JSON结构),表示上行接收成功
- 如返回的是非数字0,平台会把客户账号标记为异常,暂停向该账号推送新的上行报告,并且每隔1分钟重推一次原上行报告;如连续推送10次都没有返回数字0,推送间隔改为5分钟重试一次,直到客户返回数字0才恢复正常推送
- 注意:上行报告中可能会存在表情符“😃”,没有配置utf8mb4的Mysql表会插入失败引起程序异常,接入时请注意