Kchat机器人题库
此接口提供给客服和管理员,用来对Kchat机器人题库进行操作。
问题列表
请求URL
GET /apiv2/robot/questions.json
Query参数
Name | Required | Type | Comment |
category_id | 否 | number | 所属问题分组ID |
page | 否 | number | 页码,默认为 1 |
per_page | 否 | number | 分页尺寸,默认为 100 |
返回示例
{
"rows": [
{
"id": 13,
"category_id": 18,
"title": "新问题",
"other_titles": [
"测试数据"
],
"answer": "智能机器人正在为您服务。",
"active": 1,
"remark": "",
"created_at": "2016-01-20 14:19:43",
"question_category": {
"id": 18,
"title": "新分组"
}
},
......
],
"count": 26,
"next_page": null,
"previous_page": null
}
创建问题
请求URL
POST /apiv2/robot/questions.json
Body参数
Name | Required | Type | Comment |
data | 是 | array | 问题信息 |
data[i].category_id | 是 | number | 问题分组ID |
data[i].title | 是 | string | 问题 |
data[i].answer | 是 | string | 答案 |
data[i].other_titles | 否 | array | 相似问法 |
data[i].active | 否 | number | 是否启用,可选值:0 或 1 |
Body示例
{
"data": [
{
"category_id": 18,
"title": "退货",
"answer": "稍等,请提供订单号",
"other_titles": ["我要换货","我要退订"],
"active": 1
},
......
]
}
修改问题
请求URL
PUT /apiv2/robot/questions/{id}.json
Body参数
Name | Required | Type | Comment |
data | 是 | object | 问题信息 |
data.category_id | 是 | number | 问题分组ID |
data.title | 是 | string | 问题 |
data.answer | 是 | string | 答案 |
data.other_titles | 否 | array | 相似问法 |
data.active | 否 | number | 是否启用,可选值:0 或 1 |
Body示例
{
"data": {
"category_id": 18,
"title": "退货",
"answer": "稍等,请提供订单号",
"other_titles": ["我要换货","我要退订"],
"active": 1
}
}
删除问题
请求URL
DELETE /apiv2/robot/questions.json
Body参数
Name | Required | Type | Comment |
ids | 是 | array | 问题ID集合 |
Body示例
{
"ids": [13,14]
}
分组列表
请求URL
GET /apiv2/robot/question_categories.json
Query参数
Name | Required | Type | Comment |
page | 否 | number | 页码,默认为 1 |
per_page | 否 | number | 分页尺寸,默认为 100 |
返回示例
{
"rows": [
{
"id": 18,
"title": "技术问题"
},
......
],
"count": 8,
"next_page": null,
"previous_page": null
}
创建分组
请求URL
POST /apiv2/robot/question_categories.json
Body参数
Name | Required | Type | Comment |
data | 是 | array | 分组名称 |
Body示例
{
data:["技术问题","售后问题"]
}
修改分组
请求URL
PUT /apiv2/robot/question_categories/{id}.json
Body参数
Name | Required | Type | Comment |
data | 是 | object | 分组信息 |
data.title | 是 | string | 分组名称 |
Body示例
{
data:{
title:"分类123"
}
}
删除分组
请求URL
DELETE /apiv2/robot/question_categories.json
Body参数
Name | Required | Type | Comment |
ids | 是 | array | 分组ID集合 |
Body示例
{
"ids": [18,19]
}