# 人工监管功能相关服务
# 答案点赞点踩等
开始使用前,调用相关服务,使得用户可对问题答案进行点赞、点踩等操作。
接口描述
- 用户的点踩、点赞、点击、点下一页、分享等行为
请求
GET https://apigate.glodon.com/api/front/userAction
1
请求param参数
| 参数 | 参数类型 | 参数约束 | 是否必传 | 示例值 | 描述 |
|---|---|---|---|---|---|
| cid | 字符串 | 服务端获取 | 是 | 2e604f02-29c5-4843 -affd-533e0e497ee8 | 单个会话的唯一标识,可以从以下接口获取: - 根据问题id,获取答案 - 根据算法匹配,获取答案 - 根据算法匹配,获取答案V2 - 根据问题id,获取流程项 - 根据问题id,获取关联问题答案 |
| chatid | 字符串 | 服务端获取 | 是 | 74139073-4cfd-449b -9479-7e2fb4895d4d | 会话ID,同一会话ID可能包含多组问答, 从初始会话 开始新会话 api获取 |
| robot | 字符串 | 服务端获取 | 是 | GCCP | 机器人标识: 每次刚打开或者是切换机器人时, 从 获取机器人列表 接口获取 |
| channel | 整型 | 1/2/3/4/5/6 | 是 | 2 | 1.PC 2.公众号 3.网站 4.个人微信 5.小程序 6.APP |
| action | 字符串 | up/down/click/another/share | 是 | up | up:点赞(用户对当前答案满意) down:点踩(用户不满意当前的答案) click:点击换一批的引导问题的时候传递,具体场景参考下图 another:点击换一批(PC端使用) share:分享(分享该问题) |
传递请求的参数 action:click 的具体场景
| 场景: 点击换一批的引导问题的时候传递 |
|---|
![]() |
请求成功返回的数据
请求成功正确返回的数据基本示例
{
"code": 200,
"message": "success"
}
1
2
3
4
5
2
3
4
5
请求失败返回的数据
请求失败返回的数据基本示例 查看其它状态码
{
"code": 400,
"message": "Required parameter 'chatid' is not present"
}
{
"code": 400,
"message": "userAction.action: 'xx' is invalid action. valid action must be in ('up','down','click','another','share')"
}
{
"code": 400,
"message": "userAction.channel: value must be between 1 and 6"
}
{
"code": 500,
"message": "java.lang.IndexOutOfBoundsException"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 答案点踩反馈
用户与机器人交互前,调用相关服务,使用户可对问题答案点菜后进行原因反馈。
接口描述
- 用户对答案点踩后进行原因反馈
请求
GET https://apigate.glodon.com/api/front/knowledgeFeedback
1
请求header参数
| 参数 | 参数类型 | 参数约束 | 是否必传 | 示例值 | 描述 |
|---|---|---|---|---|---|
| session-id | 字符串 | 服务端返回,可从以下api中获取: - 开始新会话 - 会话超时,重启会话 | 否 | C3D205E1B4C72BF451CDC326328786A5 | 索引用户信息的key |
请求param参数
| 参数 | 参数类型 | 参数约束 | 是否必传 | 示例值 | 描述 |
|---|---|---|---|---|---|
| cid | 字符串 | 服务端获取 | 是 | 2e604f02-29c5-4843 -affd-533e0e497ee8 | 单个会话的唯一标识,可以从以下接口获取: - 根据问题id,获取答案 - 根据算法匹配,获取答案 - 根据算法匹配,获取答案V2 - 根据问题id,获取流程项 - 根据问题id,获取关联问题答案 |
| chatid | 字符串 | 服务端获取 | 是 | 74139073-4cfd-449b -9479-7e2fb4895d4d | 会话ID,同一会话ID可能包含多组问答, 从初始会话 开始新会话 api获取 |
| robot | 字符串 | 服务端获取 | 是 | GCCP | 机器人标识: 每次刚打开或者是切换机器人时, 从 获取机器人列表 接口获取 |
| channel | 整型 | 1/2/3/4/5/6 | 是 | 2 | 1.PC 2.公众号 3.网站 4.个人微信 5.小程序 6.APP |
| label | 字符串 | 小于等于20字符 | 否 | 回答的不对 | 用户反馈时选择的标签内容 |
| advice | 字符串 | 小于等于50字符 | 否 | 很好,满意 | 用户反馈时输入的反馈内容 |
请求成功返回的数据
请求成功正确返回的数据基本示例
{
"code": 200,
"message": "success"
}
1
2
3
4
5
2
3
4
5
请求失败返回的数据
请求失败返回的数据基本示例 查看其它状态码
{
"code": 400,
"message": "Required parameter 'chatid' is not present"
}
{
"code": 400,
"message": "robots.channel: value must be between 1 and 6"
}
{
"code": 500,
"message": "java.lang.IndexOutOfBoundsException"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
# 会话解决情况评价反馈
用户与机器人交互前,调用相关服务,使用户可以评价服务的解决情况。
接口描述
- 退出程序时,可对本次服务的解决情况进行评价及意见反馈
请求地址
GET https://apigate.glodon.com/api/front/robotFeedback
1
请求header参数
| 参数 | 参数类型 | 参数约束 | 是否必传 | 示例值 | 描述 |
|---|---|---|---|---|---|
| session-id | 字符串 | 服务端返回,可从以下api中获取: - 开始新会话 - 会话超时,重启会话 | 否 | C3D205E1B4C72BF451CDC326328786A5 | 索引用户信息的key |
请求param参数
| 参数 | 参数类型 | 参数约束 | 是否必传 | 示例值 | 描述 |
|---|---|---|---|---|---|
| feedbackType | 整型 | 0/1/2 | 是 | 1 | 0为未解决,1为解决,2为超时默认设置 |
| chatid | 字符串 | 服务端获取 | 是 | 74139073-4cfd-449b -9479-7e2fb4895d4d | 会话ID,同一会话ID可能包含多组问答, 从初始会话 开始新会话 api获取 |
| robot | 字符串 | 服务端获取 | 是 | GCCP | 机器人标识: 每次刚打开或者是切换机器人时, 从 获取机器人列表 接口获取 |
| label | 字符串 | 小于等于20字符 | 否 | 回答的不对 | 用户反馈时选择的标签内容 |
| advice | 字符串 | 小于等于50字符 | 否 | 很好,满意 | 用户反馈时输入的反馈内容 |
请求成功返回的数据
请求成功正确返回的数据基本示例
{
"code": 200,
"message": "success"
}
1
2
3
4
5
2
3
4
5
请求失败返回的数据
请求失败返回的数据基本示例 查看其它状态码
{
"code": 400,
"message": "Required parameter 'chatid' is not present"
}
{
"code": 400,
"message": "robotFeedback.feedbackType: 'xx' is invalid feedbackType. valid feedbackType must be in ('0','1','2')"
}
{
"code": 500,
"message": "java.lang.IndexOutOfBoundsException"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
