获取营员评价
按订单号与营员编号主动拉取评价详情。亦可在收到 营员评价通知 后,用于核对或补拉(回调内已含 comment_data,主动接口返回的评价 value 一般为明文)。
POST/api/getStudentComment
请求参数
| 名称 | 类型 | 描述 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
| token | String | 身份校验令牌 | 必填 | - | 由 获取访问令牌 获得 |
| ordernum | String | 订单号 | 必填 | - | 回调中也会带上 |
| sid | Number | 营员编号 | 必填 | - | 回调中也会带上 |
CURL
curl --location --request POST 'https://open.xinduobang.cn/api/getStudentComment' \
--header 'Content-Type: application/json' \
--data-raw '{
"token": "YOUR_TOKEN",
"ordernum": "NO20230628105851839641",
"sid": 3606
}'
成功响应
{
"code": 0,
"msg": "操作成功",
"data": [
{
"id": "285",
"data_type": "1",
"period_id": "5300",
"period_name": "2023/06/06-2023/06/07",
"day": "2023-05-30",
"pid": "901",
"product_name": "亲子规格",
"sid": "3606",
"s_name": "测试测试",
"info": [
{
"name": "nengli",
"type": "star",
"title": "沟通能力",
"value": "5",
"key": "nengli"
},
{
"name": "textName",
"type": "text",
"title": "一句话评价",
"value": "好1",
"key": "textName"
},
{
"name": "performance_today",
"type": "text",
"title": "今日表现",
"value": "好2",
"key": "performance_today"
},
{
"name": "textareaName",
"type": "textarea",
"title": "多行文本",
"value": "好3",
"key": "textareaName"
}
]
}
]
}
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 评价记录唯一 ID |
| data_type | String | 1 营地反馈,2 周末大反馈 |
| period_id | String | 营期 ID |
| period_name | String | 营期名称 |
| day | String | 评价日期(同一营期可能有多天) |
| pid | String | 营种 ID |
| product_name | String | 营种名称 |
| sid | String | 营员编号 |
| s_name | String | 营员姓名 |
| info | Array | 评价项列表,元素含 name、type、title、value、key |
无评价时 data 为空数组。
失败响应
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 非 0 | 业务错误 | 确认订单存在且包含该营员;检查 token |
相关接口
- 评价推送回调:
营员评价通知