Mod 制作与开放生态 / 开放生态

业务事件 Webhook

已验证Web · 已验证代码更新于 2026-08-05

订单等业务事件可回调通知企业外部系统,实现双向集成。

功能价值

订单等业务事件可回调通知企业外部系统,实现双向集成。

使用方式

在集成配置中登记回调地址并订阅事件。

所属模块

Mod 制作与开放生态 / 开放生态

适用平台

Web · 已验证

已知限制

  • 重试与幂等语义以接口文档为准

平台验证状态

本项适用于 1 个平台,逐平台独立判定:平台状态只由该平台的实机验收记录产生,总体状态由平台状态自动汇总,目录与页面都不存放可手写的状态。验收结论仅覆盖记录所列版本、Git SHA 与产物;当前源码或新安装包仍需独立验收。

Web

已验证

验收结果:PASS;通过 4 / 失败 0;产品版本 1.0.0.5;Git SHA 086a98f1fbad9f9b357692a85e656d8972cb6bc3;验证时间 2026-09-29。Acceptance JSON SHA-256 83eb6152606e7b4b288d39c9b6cba68494ebc62f3ae2f8f13aa2dc69d019a9aa

实机录像 / 操作流程

媒体内容已复核,记录结论:验收结果:通过;画面内容:本轮真实浏览器会话录像(webm,16.72s,ffmpeg 实测):管理员登录 → 合法信封受理 → 幂等去重 → 空信封 400 → 伪造 400 → GET 404。;SHA-256:28f45bbcb81603649c6849f7b3efdd5d1ab2ed0c6b9b9826b55dc9d35fbc9517(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/mods-webhook/video/mods-webhook-web-20260929-160413.webm) 下载原始录像

实机截图

业务事件 Webhook 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:管理端登录页「XCMAX 服务器后台 · 管理员登录」,账号框已填 admin、密码框为掩码。;SHA-256:84c52c2e50ad61ac2ae6fa9a3b3b4447e05f52d8b9d8f2eeef679c24c0d06f73(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/mods-webhook/shot/00-login-form.png) 查看原图
业务事件 Webhook 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:卡片显示两处真实响应:POST 首次合法 payment.paid envelope 返回 200 data={accepted:true,deduped:false,emitted:true,out_trade_no:VC-ACCEPT-0001};重投同 envelope.id 返回 200 data={accepted:true,deduped:true,out_trade_no:VC-ACCEPT-0001}(幂等去重)。;SHA-256:6bc8a09e2992527c7966b656c4e883531ef0bace00b9ab021a865716aa5ca632(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/mods-webhook/shot/W1-webhook-accepted.png) 查看原图
业务事件 Webhook 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:卡片显示三处真实响应:POST 空信封 400 reason=invalid_envelope;POST 伪造事件 400 reason=invalid_envelope;GET /api/xcmax/webhooks/modstore/payment 404(仅 POST 注册)。;SHA-256:82d7b549d3d204bc351e14b319432797703432d1d649bfbb865ac3e6c78a3273(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/mods-webhook/shot/W2-webhook-boundary.png) 查看原图

运行日志

下载原件:mods-webhook-web-20260929-160413.log;SHA-256:171754ab88d4a60881db99fbb0076666a5f1c6d9eb19ded49eecc79a52b4455d(仓库路径:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/mods-webhook/log/mods-webhook-web-20260929-160413.log)

安装包 / 部署产物 SHA-256:cfa52148ab19fd69e6bea715cc2b9ad046f9607dbdee31033cb9d5357d3c7368 · 交付身份 JSON

实现与测试(平台无关)

图片内容复核(2026-09-30,Mac 1.0.0.5):AI 员工市场选中宿主基础能力,暂无商品。

源码实现

  • FHD/app/fastapi_routes/order_event_webhook.py

自动化测试

暂无

CI 门禁:待补本项 CI 证据

CI 工作流定义

暂无

证据原件存放于私有对象存储,页面通过短时效签名地址读取原图与原始录像; 「核验哈希」会对照本页登记的 SHA-256 与存储对象元数据。对象存储不可用时自动改用站内副本, 也可下载原件后用 sha256sum 自行核对。