推送上行短信
功能说明:开通此接口后,我们将为您实时推送最新的上行短信。您需要提供一个callback url地址,接受http post请求。 该接口一次最多推送100个状态报告,为不影响推送速度,建议先接受数据后再做异步处理。
备注:#
- 本功能默认不开启,如需开启请前往“系统设置-上行短信推送”页设置。
- 接收到数据后,数据处理成功请返回字符串"SUCCESS",其他返回值将被认为是失败。该接口失败重试次数为3次,每次间隔5分钟。
- 获取到的上行短信与下行短信的对应关系匹配的是最新一条规则
- 上行短信内容可能会有重复
HTTP头信息:#
Content-Type:application/json;charset=utf-8;请求#
URL:http://your_receive_url_address 访问方式:POST 访问参数: 已JSON 格式推送请求参数#
| 名称 | 类型 | 描述 |
|---|---|---|
| success | boolean | 是否请求成功 false 为接口请求失败,请求失败 data 中无数据 |
| errorCode | string | 错误码 200 代表成功 |
| errorMessage | string | 错误提示 |
| data | object[] | 上行短信数据,是一个数组;格式参考下面 |
data 请求参数#
| 名称 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| mobile | string | 是 | 手机号 |
| sid | long(64 位) | 是 | sid 下行短信对应sid |
| busId | string | 否 | 下行短信上送的业务系统内的 ID |
| content | string | 是 | 短信内容 |
| receiveTime | string | 否 | 上行短信发送时间 |
Json响应示例#
{ "success": true, "errorCode": "200", "errorMessage": "成功", "data": [ { "mobile": "13711111111", "content": "T", "busId": "1111", "receiveTime": "2021-10-11 15:10:50", "sid": 10101 } ]}