获取状态报备
/
秒信通平台支持主动拉取模式（轮询拉取）和被动接收（回调推送 / HTTP 推送）两种模式。
一、主动拉取模式调用
注意：每条短信状态仅可获取一次
1.1 请求地址
地址：https://www.8dx.cn/api/report
请求方式：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 | 扩展号,调用发送接口返回的msg_id,手机号,状态,时间,售价 字段以,分隔 多条记录以|分隔 | 123,2,1762532xxxx,DELIVRD,2021-12-23 01:02:03,0.2|123,2,17862532xxxx,DELIVRD,2021-12-23 01:02:03,0.1 |
二、推送状态报告(每条短信仅推送一次)
采用推送状态报告模式的，首次使用需要登入秒信通控制台，进行获取方式的配置。
新开账户默认为主动拉取方式，如需改为被动接收模式需要登录控制台修改
被动接收模式的推送地址登录控制台配置。
单个SPID账号同一时间只能选择一种获取方式。
推送状态报告(每条短信仅推送一次)
注意事项：推送使用的是POST方式，utf8原始字节流
推送格式：扩展号,调用发送接口返回的msg_id,手机号,状态,时间,售价 字段以,分隔 多条记录以|分隔
内容示范：123,2,1762532xxxx,DELIVRD,2021-12-23 01:02:03,0.2|123,2,17862532xxxx,DELIVRD,2021-12-23 01:02:03,0.1
被动推送模式配置项详解
被动接收（回调推送）完整配置包含 4 项核心参数：
推送地址、推送端口、状态 URL、上行回复 URL，各司其职，不可混淆。
1. 推送地址（公网服务器 IP/域名）
含义：你业务服务器对外可访问的域名或公网 IP，是平台能连通你服务的基础地址。
示例：
api.xxx.com/120.xx.xx.110作用：平台通过该地址建立网络连接，发起 HTTP 推送请求。
要求：必须公网可访问，防火墙、安全组放行对应端口。
2. 推送端口
含义：你的服务监听接收推送请求的端口号。
常用：HTTP 默认 80、HTTPS 默认 443；自定义后端端口如 8080、8090、9001。
规则：
域名 + 80/443 可省略端口；
自定义端口必须完整配置，否则平台无法访问接口。
示例完整地址：
api.xxx.com:8090
3. 状态 URL（短信状态报告回调地址）
全称：送达回执 URL，拼接在推送地址 + 端口之后的接口路径。
完整拼接格式：
http://推送地址:推送端口/自定义路径示例：
https://api.xxx.com:443/sms/report推送内容：短信下发回执，包含 msgid、手机号、送达状态、错误码、发送时间等。
业务用途：更新订单发送状态、判断是否下发成功、失败重发逻辑。
4. 上行回复 URL（用户回复短信回调地址）
路径独立接口，和状态 URL 分开配置。
示例：
https://api.xxx.com:443/sms/mo推送内容：用户主动回复的上行短信（MO 消息），包含手机号、回复内容、接收时间。
业务用途：处理用户回复、营销互动、退订指令（TD / 退订）、客服问答。
完整拼接示例
推送地址：sms-callback.xxx.com
推送端口：8080
状态 URL 路径：/sms/report
上行 URL 路径：/sms/mo
状态完整推送地址：
http://sms-callback.xxx.com:8080/sms/report上行完整推送地址：
http://sms-callback.xxx.com:8080/sms/mo
配套落地要点
两个 URL 接口需分开开发，分别处理回执、上行两类数据；
统一增加签名鉴权，防止恶意伪造推送请求；
接口快速返回 200 OK，耗时逻辑异步处理，避免平台超时重试；
基于 msgid 做幂等，解决重复推送问题；
若使用 HTTPS，端口固定 443，无需额外填写端口。