Webhook 回执字段详情

本文档详细说明短信回执 Webhook 推送的字段详情。

推送字段说明

字段	类型	说明
MsgType	int	消息类型，固定值：2
Data	array	回执数据列表

Data 项字段

字段	类型	说明
SessionNo	string	批次唯一 ID
Phone	string	收信手机号
CostCount	int	本条短信消耗条数
ReceiptTime	int	回执时间戳（Unix 秒）
ReceiptResult	string	回执结果，Success 表示发送成功
ReceiptCode	string	回执状态码，0 表示成功
ReceiptDesc	string	回执描述

推送 JSON 示例

{
  "MsgType": 2,
  "Data": [
    {
      "SessionNo": "cbfaf1a2-9d12-4f8a-81c7-56f67ba708ea",
      "Phone": "123456",
      "CostCount": 1,
      "ReceiptTime": 1781580389,
      "ReceiptResult": "Success",
      "ReceiptCode": "0",
      "ReceiptDesc": "发送成功"
    }
  ]
}

推送机制说明

推送配置

• 推送方式：HTTP POST
• Content-Type：application/json
• 重试机制：每个回调地址最多重试 3 次
• 批量推送：支持批量推送多条消息
• 超时时间：默认 30 秒

响应格式

客户端需要返回以下格式的 JSON 响应：

{
  "code": 0,
  "message": "success"
}

• code = 0 表示成功
• code != 0 表示失败，会触发重试机制