跳到主要内容
版本:v2.0

团组变更通知

营员在营期内的分团/分组发生变更时,平台会向友商配置的回调地址 POST 推送变更前后团组信息。

POST友商回调地址(配置路径:后台-设置-开放平台-订阅事件-添加订阅)

配置方式

  1. 登录信多帮管理后台
  2. 进入 后台 → 设置 → 开放平台 → 订阅事件 → 添加订阅
  3. 选择「团组变更」事件,填写友商回调 URL
  4. 保存后,营员分团/分组变更时将自动推送
说明
  • 回调为服务端对服务端请求,请确保 URL 公网可访问
  • 收到回调后请返回 HTTP 200
  • 推送内容为 JSON,字段即下方表格,无额外的 type 包装层

请求体字段

顶层字段

字段类型说明
sidString营员编号
order_snString订单号
period_idNumber营期 ID
s_nameString营员姓名
period_nameString营期名称,如 2023/07/05-2023/07/19
product_nameString营种名称
old_dataObject变更前团组信息
new_dataObject变更后团组信息

old_data / new_data — 团组信息

查询订单 接口返回的团组信息字段一致:

字段类型说明
cut_idString / Number分团 ID
team_nameString团名称,如 1团
team_nick_nameString团昵称
group_idString / Number分组 ID
group_nameString组名称,如 1组
group_nick_nameString组昵称
提示

若营员原先未分配团组,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 去重

相关接口