获取短信回执报告接口

此接口只能查询当天短信回执报告,跨天的短信状态无法查询。建议使用HTTP主动推送回执接口效率更高。

接口状态

已完成

接口URL

http://127.0.0.1:9990/sms/json/report

请求方式

POST

Content-Type

json

请求Header参数

参数名	示例值	参数类型	是否必填	参数描述
Authorization	eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6ImIzNmNkNTczLTJhNjQtNGUxNi1iZTQ1LTVkMDYyMmJmNjZhNSJ9.PgBBYnrC0f5HL7iVaJbanCGhZHcyf4y2B-MHQYswi91wf4ftWNHz9nZtVzC-605so8kM296nBAyCxSdSkZ8CNw	String	是	TOKEN头

请求Body参数

{
    "msgBatchNo":"6666524179307525"
}

参数名	示例值	参数类型	是否必填	参数描述
msgBatchNo	1522813521188134912	String	是	消息ID,最大只能支持10个消息ID查询,多个ID用英文,号分割。{注意:重复的消息ID会过滤掉}

认证方式

noauth

成功响应示例

{
    "msg": "成功",
    "code": 200,
    "data": [
        {
            "msgBatchNo": "1522813521188134912",
            "flag": 1,
            "mobile": "19965411512",
            "accessCode": "1069015",
            "stat": "DELIVRD",
            "time": "1651914142852",
            "result": 0
        }
    ]
}

参数名	示例值	参数类型	参数描述
msg	成功	String	描述
code	200	Number	状态码
data	-	Object	返回数据
data.msgBatchNo	1522813521188134912	String	消息ID
data.flag	1	Number	标记 0=手机用户上行 1=状态报告
data.mobile	19965411512	String	获取状态的手机号
data.accessCode	1069015	String	接入码
data.stat	DELIVRD	String	回执状态,一般情况下非DELIVRD状态都是失败状态（其中:1 提交到网关成功 2 提交网关失败 3 未知 4 转发给上游成功 5 转发失败），具体含义请联系管理员！
data.time	1651914142852	String	获取时间
data.result	-	Number	获取状态 0=获取成功 1=此回执报告未查询到

作者：smswg 创建时间：2023-06-09 15:14
最后编辑：smswg 更新时间：2025-06-27 15:13