1. 首页
  2. 秒信通MiCPaaS
  3. 🗊 国内短信
  4. 🗊 API接口
  5. 🗎 获取上行报告
菜单
本页目录

获取上行报告(回复短信)

信息

秒信通平台支持主动拉取模式(轮询拉取)和被动接收(回调推送 / HTTP 推送)两种模式。

一、主动拉取模式调用

注意:每条短信状态仅可获取一次

1.1 请求地址

地址:https://www.8dx.cn/api/get-reply
请求方式:GET 返回值:JSON

提示

手机回复上行后,此接口就能拉取到上行数据,每个上行数据只能拉取到一次,所以调用者拉到上行后,需要将上行的内容存在本地,然后自行根据 msg_id,手机号 等信息匹配具体哪条短信产生的上行回复

1.2 请求地址

API参数表格
参数名 参数介绍 示例 必填
sp_id 产品sp_id 175298
signature 签名(和密码二选一即可) a92569901189f2574effc957c096c432e2d47635
password 密码(和签名二选一即可),通过sp_id的密码进行md5处理 60465589668c72c8f2eb560050ac4c0c

1.3 响应参数

API参数表格
参数名 参数介绍 示例
code 详情见错误表 0
msg 成功-success 错误-其他提示 success
data urlencode后的内容,手机号,调用发送接口返回的msg_id,扩展号,时间 字段以,分隔多条记录以|分隔 TD,158114xxxx,100000006,048842426601,20220325123304|退订,1891456xxxx,100000007,0615,20211115173903

二、推送用户上行回复(每条短信仅推送一次)

采用推送上行报告模式的,首次使用需要登入秒信通控制台,进行获取方式的配置。

  1. 新开账户默认为主动拉取方式,如需改为被动接收模式需要登录控制台修改

  2. 被动接收模式的推送地址登录控制台配置。

  3. 单个SPID账号同一时间只能选择一种获取方式。

重要信息

注意事项:推送的是POST方式,utf8原始字节流

推送格式:urlencode后的内容,手机号,扩展号,时间 字段以,分隔多条记录以|分隔

内容示范:TD,158114xxxx,048842426601,20220325123304|退订,1891456xxxx,0615,20211115173903