营员评价通知
营员评价审核通过并发送后,平台会向友商配置的回调地址 POST 推送通知。推送包含营员编号、订单号,以及评价详情(comment_data)。
POST友商回调地址(配置路径:后台-设置-开放平台-订阅事件-添加订阅)
配置方式
- 登录信多帮管理后台
- 进入 后台 → 设置 → 开放平台 → 订阅事件 → 添加订阅
- 选择「营员评价」事件,填写友商回调 URL
- 保存后,评价审核发送时将自动推送
说明
- 收到回调后请返回 HTTP 200
- 推送内容为 JSON(裸 JSON,无
type/request_data包装) comment_data.data.info[].value为 Base64 编码后的评价内容,接收后需自行解码
请求体字段
| 字段 | 类型 | 说明 |
|---|---|---|
| sid | String / Number | 营员编号 |
| ordernum | String | 关联订单号(同营期有效订单) |
| comment_data | Object | 评价详情包装,见下表 |
comment_data
| 字段 | 类型 | 说明 |
|---|---|---|
| code | Number | 2 表示评价详情可用;1 表示未取到评价记录 |
| data | Object | 评价正文;code 为 2 时有效 |
comment_data.data
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String / Number | 评价记录唯一 ID |
| data_type | Number | 1 营地反馈,2 周末大反馈 |
| period_id | String / Number | 营期 ID |
| period_name | String | 营期名称 |
| day | String | 评价日期,如 2023-06-06 |
| pid | String / Number | 营种 ID |
| product_name | String | 营种名称 |
| sid | String / Number | 营员编号 |
| s_name | String | 营员姓名 |
| info | Array | 评价项列表 |
comment_data.data.info[]
| 字段 | 类型 | 说明 |
|---|---|---|
| name | String | 表单项 name |
| type | String | 如 star、text、textarea |
| title | String | 展示标题 |
| value | String | 评价内容(Base64) |
| key | String | 表单项 key |
请求示例
{
"sid": "2579",
"ordernum": "NO20230628105851839641",
"comment_data": {
"code": 2,
"data": {
"id": 286,
"data_type": 1,
"period_id": "5300",
"period_name": "2023/06/06-2023/06/07",
"day": "2023-06-06",
"pid": "901",
"product_name": "营种名称",
"sid": "2579",
"s_name": "营员姓名",
"info": [
{
"name": "nengli",
"type": "star",
"title": "沟通能力",
"value": "NA==",
"key": "nengli"
},
{
"name": "textName",
"type": "text",
"title": "一句话评价",
"value": "MjI=",
"key": "textName"
}
]
}
}
}
示例中 value 仅为占位(Base64);实际以推送为准。解码后可读明文评价内容。
接收方要求
| 项目 | 要求 |
|---|---|
| 响应状态码 | 返回 HTTP 200 表示接收成功 |
| 幂等 | 同一评价可能因重试多次推送,请按评价 id 或 sid+day 等做幂等 |
| 备用拉取 | 亦可调用 获取营员评价 核对或补拉(主动接口返回的 value 一般为明文) |
相关接口
- 主动拉取评价:
获取营员评价