说明 SaaS 消息通知的接收方式、请求结构与响应要求,适用于事件回调与运营集成场景。
消息通知采用服务端回调方式。系统向预设域名下的接收地址发送 POST 请求,接收方处理完成后需返回字符串 success 作为成功确认。
POSTsuccess请求体格式:application/json
| 字段名 | 类型 | 必选 | 说明 |
|---|---|---|---|
data | object | 是 | 通知数据对象 |
notify_id | string | 是 | 通知 ID |
notify_time | string | 是 | 通知时间 |
data 对象结构:
| 字段名 | 类型 | 必选 | 说明 |
|---|---|---|---|
ppt_id | string | 否 | 生成 PPT 的任务 ID |
type | string | 是 | 通知类型 |
time | string | 是 | 事件时间,格式为 Y-m-d H:i:s |
app_name | string | 是 | 应用名称 |
union_id | string | 否 | 用户唯一识别 ID |
type 字段枚举值:
| 枚举值 | 描述 |
|---|---|
PPT-Download | PPT 下载 |
SYSTEM | 系统通知 |
PPT-Online-Download | 编辑器下载 |
PPT-Create | PPT 生成 |
{
"data": {
"ppt_id": "eTrNUASpGSb7CbXjh5huQPEMJBKyZwTv",
"type": "PPT-Download",
"time": "2025-01-06 14:33:47",
"app_name": "智能PPT"
},
"notify_id": "756571379632283648",
"notify_time": "2025-03-06 11:45:24"
}成功响应:
"success"notify_id、type、ppt_id 等关键字段,再进入异步业务处理PPT-Create、PPT-Download 等事件,建议在业务系统中补充操作日志,便于审计与问题排查success,否则发送方会认为通知失败