首页

Webhook转发字段说明

本文档描述 Webhook 推送时的 JSON 载荷结构，用于开发者对接回调消息。

JSON 样例

{
"ctype": "application/json",
"platform": "maileroo",
"hash": "short_account_hash_001",
"raw_body_b64": "eyJ0byI6ImZseWluZzk5a29vQDE2My5jb20ifQ=="
}

字段释义

字段名 类型 说明
ctype 字符串 原始回调请求的 Content-Type。当前支持：
application/json、application/x-www-form-urlencoded，其它类型消息会被丢弃。
platform 字符串 服务商平台标识，例如 maileroo，用于区分消息来源。
hash 字符串 服务商平台账号唯一标识，对应一组回调配置，用于路由匹配。
raw_body_b64 字符串 原始回调 POST 报文，Base64 编码。
接收方需要对该字段进行 Base64 解码，得到原始请求体。
补充说明：

  • 原始报文原样透传，不会修改上游推送内容；
  • 解码后按照 ctype 对应格式解析数据；
  • 格式校验失败的消息会直接丢弃，不会重复推送。