获取上行报告(回复短信)
信息
秒信通平台支持主动拉取模式(轮询拉取)和被动接收(回调推送 / HTTP 推送)两种模式。
一、主动拉取模式调用
注意:每条短信状态仅可获取一次
1.1 请求地址
地址:https://www.8dx.cn/api/get-reply
请求方式:GET 返回值:JSON
提示
手机回复上行后,此接口就能拉取到上行数据,每个上行数据只能拉取到一次,所以调用者拉到上行后,需要将上行的内容存在本地,然后自行根据 msg_id,手机号 等信息匹配具体哪条短信产生的上行回复
1.2 请求地址
| 参数名 | 参数介绍 | 示例 | 必填 |
|---|---|---|---|
| sp_id | 产品sp_id | 175298 | 是 |
| signature | 签名(和密码二选一即可) | a92569901189f2574effc957c096c432e2d47635 | 否 |
| password | 密码(和签名二选一即可),通过sp_id的密码进行md5处理 | 60465589668c72c8f2eb560050ac4c0c | 否 |
1.3 响应参数
| 参数名 | 参数介绍 | 示例 |
|---|---|---|
| code | 详情见错误表 | 0 |
| msg | 成功-success 错误-其他提示 | success |
| data | urlencode后的内容,手机号,调用发送接口返回的msg_id,扩展号,时间 字段以,分隔多条记录以|分隔 | TD,158114xxxx,100000006,048842426601,20220325123304|退订,1891456xxxx,100000007,0615,20211115173903 |
二、推送用户上行回复(每条短信仅推送一次)
采用推送上行报告模式的,首次使用需要登入秒信通控制台,进行获取方式的配置。
新开账户默认为主动拉取方式,如需改为被动接收模式需要登录控制台修改
被动接收模式的推送地址登录控制台配置。
单个SPID账号同一时间只能选择一种获取方式。

重要信息
注意事项:推送的是POST方式,utf8原始字节流
推送格式:urlencode后的内容,手机号,扩展号,时间 字段以,分隔多条记录以|分隔
内容示范:TD,158114xxxx,048842426601,20220325123304|退订,1891456xxxx,0615,20211115173903