主动获取上行短信
功能说明:#
上行短信数据,保存时间为三个月。 您可以通过此接口获取新产生的上行短信。注意,已成功获取的数据将会删除,请妥善处理接口返回的数据。
备注:#
- 建议使用单线程获取。
- 获取到的上行短信与下行短信的对应关系匹配的是最新一条规则
HTTP头信息(具体参考调用说明):#
Accept:application/json;charset=utf-8; Content-Type:application/json;charset=utf-8; X-SIGNATURE: $signature; X-APIKEY: $APIKEY; X-TIMESTAMP: $timestamp; X-NONCE: $nonce;请求#
URL:https://gateway.yihuitong.top/openapi/sms/pullUpSms 访问方式:GET请求参数#
| 参数名 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|
| pageSize | integer | 否 | 每页个数,最大1000个,默认100个 | 100 |
响应参数#
| 名称 | 类型 | 描述 |
|---|---|---|
| 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 } ]}