团组变更通知
营员在营期内的分团/分组发生变更时,平台会向友商配置的回调地址 POST 推送变更前后团组信息。
POST友商回调地址(配置路径:后台-设置-开放平台-订阅事件-添加订阅)
配置方式
- 登录信多帮管理后台
- 进入 后台 → 设置 → 开放平台 → 订阅事件 → 添加订阅
- 选择「团组变更」事件,填写友商回调 URL
- 保存后,营员分团/分组变更时将自动推送
说明
- 回调为服务端对服务端请求,请确保 URL 公网可访问
- 收到回调后请返回 HTTP 200
- 推送内容为 JSON,字段即下方表格,无额外的
type包装层
请求体字段
顶层字段
| 字段 | 类型 | 说明 |
|---|---|---|
| sid | String | 营员编号 |
| order_sn | String | 订单号 |
| period_id | Number | 营期 ID |
| s_name | String | 营员姓名 |
| period_name | String | 营期名称,如 2023/07/05-2023/07/19 |
| product_name | String | 营种名称 |
| old_data | Object | 变更前团组信息 |
| new_data | Object | 变更后团组信息 |
old_data / new_data — 团组信息
与 查询订单 接口返回的团组信息字段一致:
| 字段 | 类型 | 说明 |
|---|---|---|
| cut_id | String / Number | 分团 ID |
| team_name | String | 团名称,如 1团 |
| team_nick_name | String | 团昵称 |
| group_id | String / Number | 分组 ID |
| group_name | String | 组名称,如 1组 |
| group_nick_name | String | 组昵称 |
提示
若营员原先未分配团组,old_data 中团名、组名等字段可能为空,ID 类字段可能为 0。
请求示例
{
"sid": "2579",
"order_sn": "NO20230628105851839641",
"period_id": 60,
"s_name": "zjy",
"period_name": "2023/07/05-2023/07/19",
"product_name": "学管师测试营",
"old_data": {
"cut_id": "217",
"team_name": "1团",
"team_nick_name": "学管师测试营",
"group_id": "328",
"group_name": "1组",
"group_nick_name": "基础1班"
},
"new_data": {
"cut_id": "217",
"team_name": "1团",
"team_nick_name": "学管师测试营",
"group_id": "329",
"group_name": "2组",
"group_nick_name": "高分1班"
}
}
接收方要求
| 项目 | 要求 |
|---|---|
| 响应状态码 | 返回 HTTP 200 表示接收成功 |
| 幂等 | 同一营员同一营期可能多次变更,建议按 sid + period_id + new_data.group_id 去重 |
相关接口
- 查询订单(含团组快照):
查询订单