Skip to content

主动推送回执接口(JSON 格式)

功能描述:

  • 由短信平台主动向客户指定的回调 URL 推送短信发送状态回执,无需客户轮询查询。

调用格式:

  • 请求方式:POST(由平台发起,客户需预先提供可公网访问的接收地址)

HTTP 头:

  • Content-Type: application/json; charset=UTF-8

请求示例:

json
{
  "reports": [
    {
      "mobile": "13812345678",
      "result": "0",
      "taskid": "211119121329715277",
      "stat": "DELIVRD",
      "num": "0",
      "report_time": "2014-01-01 16:37:31",
      "sn": ""
    },
    {
      "mobile": "13912345678",
      "result": "1",
      "taskid": "211119121329715277",
      "stat": "DB:0006",
      "num": "0",
      "report_time": "2014-01-01 10:15:26",
      "sn": ""
    }
  ]
}

请求参数:

参数名称类型是否必填说明
reportsJSONArray回执数据数组

客户响应要求:

  • 成功接收后,客户服务端必须返回以下任意一种响应内容(纯文本):
    • 0
    • succ
  • 若未按要求返回,平台可能进行重试推送。

响应字段说明:

字段描述
taskid任务编号(对应发送接口返回的 taskid
mobile接收短信的手机号码
result回执结果,0 表示成功,非 0 表示失败
stat回执状态码(如 DELIVRD 表示成功)
sn流水号(若发送时未填写,则为空字符串)
report_time回执时间,格式:yyyy-MM-dd HH:mm:ss
num长短信分片序号,从 0 开始

💡 提示:请确保回调地址稳定、支持 POST 请求,并能正确解析 UTF-8 编码的 JSON 数据体。

基于 MIT 协议发布