# 获取问题/答案相关服务

# 获取智能提示的问题

用户与机器人交互前，调用相关服务，使用户在会话前获取智能提示的相关问题。

接口描述

  • 用户输入问题时，实时获取智能提示的相关问题，包括： - 常规问题 - 流程问题 - 表格问题

请求

GET https://apigate.glodon.com/api/front/questionTips
1

请求param参数

参数 参数类型 参数约束 是否必传 示例值 描述
robot 字符串 服务端获取 是 GCCP 机器人标识: 每次刚打开或者是切换机器人时, 从 获取机器人列表 接口获取
question 字符串 最大长度500 是 GBQ4如何使用 用户输入的问题
channel 整型 1/2/3/4/5/6 是 2 1.PC 2.公众号 3.网站 4.个人微信 5.小程序 6.APP

请求成功返回的数据

请求成功返回字段描述

返回字段类型示例值描述highlight字符串后缀为< span class="highlight">GBQ4< /span>/ GZB4的文件要怎么打开？智能提示的问题，其中匹配的部分被高亮设置question字符串后缀为GBQ4/GZB4的文件要怎么打开？智能提示的问题type整型2当前问题的类型 ： - 0为常规问题 - 1为人工问题 - 2为流程问题 - 3为表格问题qid整型133256当前问题的唯一标识

请求成功返回的数据基本示例

    {
    "code": 200,
    "message": "success",
    "result": {
        "tips": [
            {
                "highlight": "后缀为<span class=\"highlight\">GBQ4</span>/GZB4/GTB4/GBG9/GPB9的文件要怎么打开？",
                "question": "后缀为GBQ4/GZB4/GTB4/GBG9/GPB9的文件要怎么打开？",                 
                "type": 2,                   
                "qid": 205534
                
            },
            {
                "highlight": "后缀为<span class=\"highlight\">GBQ4</span>/GZB4/GTB4/GBG9/GPB9的文件要怎么打开？",
                "question": "后缀为GBQ4/GZB4/GTB4/GBG9/GPB9的文件要怎么打开？",                 
                "type": 0,                   
                "qid": 205534
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

请求失败返回的数据

请求失败返回的数据基本示例 查看其它状态码

    {
        "code": 400,
		"message": "Required parameter 'question' is not present"
    }

	{
    	"code": 400,
    	"message": "questionTips.robot: value must be get from server"
	}

	{
    	"code": 400,
    	"message": "questionTips.question: Length exceeds the max value [500]"
	}

    {
        "code": 500,
		"message": "java.lang.ClassCastException"
    }
1
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/matchedResult
1

请求header参数

参数 参数类型 参数约束 是否必传 示例值 描述
session-id 字符串 服务端返回,可从以下api中获取: - 开始新会话 - 会话超时，重启会话 否 C3D205E1B4C72BF451CDC326328786A5 索引用户信息的key

请求param参数

参数 参数类型 参数约束 是否必传 示例值 描述
robot 字符串 服务端获取 是 GCCP 机器人标识: 每次刚打开或者是切换机器人时, 从 获取机器人列表 接口获取
question 字符串 最大长度500 是 GBQ4如何使用 用户输入的问题
chatid 字符串 服务端获取 是 74139073-4cfd-449b -9479-7e2fb4895d4d 会话ID，同一会话ID可能包含多组问答, 从初始会话 开始新会话 api获取
channel 整型 1/2/3/4/5/6 是 2 1.PC 2.公众号 3.网站 4.个人微信 5.小程序 6.APP
isHot 布尔型 true/false 否 true PC端数据埋点使用
isPrevPage 布尔型 true/false 否 true PC端数据埋点使用
pageNumber 整型 整型 否 1 第几页，PC端进行引导回答换一批的时候使用,值从1开始
pageSize 整型 整型 否 5 每页数量（默认5）

请求成功返回的数据

请求成功返回数据字段描述

返回字段 类型 示例值 描述
answer 字符串 因为GBQ4.0软件在分部分项界面点的重用组价，只会自动复制过来分部分项的项 返回的答案
hideUpDown 布尔型 false 用于前端显示或隐藏点踩点赞页签
cid 字符串 2e604f02-29c5-4843-affd-533e0e497ee8 单条会话的唯一标识
initialQuestion 字符串 计价GBQ4如何下载 初始问题，用于问题学习
isProfessional 整型 0 1为非专业问题，0为专业问题
resultType 整型 5 返回的数据结构类型,据此做不同的显示处理, 目前用于PC端埋点 ： - 0为引导问题 - 1为直推 - 2为引导后点击 - 3为未回答上 - 4为智能提示 - 5为闲聊 - 6为人工问题 - 7为直推下挂点击 - 8为表格问题
directQue 对象 返回字段类型示例值描述question字符串缀为GBQ4/GZB4/GTB4/GBG9/GPB9的文件要怎么打开问题htmlAnswer字符串首先打开软件，然后点击就可以了答案qid整型133256当前问题的唯一标识type整型2当前问题的类型 ： - 0为常规问题 - 1为人工问题 - 2为流程问题 - 3为表格问题 直推的数据,包含问题、答案、类型等相关信息
flowItem 对象 返回字段类型示例值描述id整型558流程项id, 用于获取下一个流程项isFirstItem布尔型true标识是不是第一个流程项, 用于控制是否显示标问 (只有第一个流程项的话才显示标问) - true: 是第一个流程项 - false: 不是第一个流程项flowName字符串第一步流程项名称flowContent字符串安装GBQ4流程项内容linkContent字符串下一步下一个流程项的链接入口, 点击能够展示出下一个流程项 流程问题的流程项（type=2） - 如果不是一个流程问题, 不返回该结构
similarQue 或 anotherQue 对象 返回字段类型示例值描述qid整型133256当前问题的唯一标识type整型2当前问题的类型 ： - 0为常规问题 - 1为人工问题 - 2为流程问题 - 3为表格问题question字符串缀为GBQ4文件要怎么打开问题 当前问题的相似问题列表 (其他字段后台使用，无需关注)

请求成功返回的数据基本示例----直推下挂 算法推出一条答案, 并返回三条相似的问题

{
	"code": 200,
	"message": "success",
	"result": {
		"similarQue": [{
			"question": "计价GBQ4.0重用组价，查询历史工程，全选自动复制组价为什么措施项目组价没有一起匹配过来？",
			"levelId": "5",
			"type": 0,
			"qid": "262189"
		}, {
			"question": "计价GBQ4.0如何返回项目管理界面？",
			"levelId": "5",
			"type": 0,
			"qid": "260847"
		}],
		"directQue": {
			"htmlAnswer": "<p>计价软件载入XML组价后，部分单位工程组价没有匹配进去是因为工程招标清单里面的部分单位工程清单编码和招标方给的招标控制价里面的清单编码不匹配。</p>",
			"question": "计价GBQ4.0项目管理界面载入XML组价后，部分单位工程组价并没有匹配进去",
			"type": 2,
			"qid": "262100",
			"flowItem": {//只有type=2才有
				"flowContent": "<p>测试1  </p>",
				"id": 483,
				"flowName": "测试1",
				"linkContent": "测试1",
				"isFirstItem": true
			}
		},			
		"answer": "<p>计价软件载入组价</p>",
		"isProfessional": 0,
		"hideUpDown": false,
		"resultType": 1,
		"initialQuestion": "计价GBQ4.0项目管理界面载入XML组价后，部分单位工程组价并没有匹配进去",
		"cid": "aec5c6a6-f269-4f61-b19f-81759c49692a"
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

请求成功返回的数据基本示例---换一批提示/分页 算法没有找到正确答案, 返回五条提示的问题

{
	"code": 200,
	"message": "success",
	"result": {
		"anotherQue": [{
			"question": "计价GBQ4.0如何找回历史工程？",
			"levelId": "5",
			"type": 0,
			"qid": "260690"
		}, {
			"question": "计价GBQ4.0软件安装之后不显示图标/显示白色/没有生成Bin文件夹怎么处理？",
			"levelId": "5",
			"type": 0,
			"qid": "262034"
		}, {
			"question": "计价GBQ4.0软件没有锁如何查看工程的数据？",
			"levelId": "5",
			"type": 0,
			"qid": "262043"
		}, {
			"question": "计价GBQ4.0如何生成招标书/投标书？",
			"levelId": "5",
			"type": 0,
			"qid": "260762"
		}, {
			"question": "计价GBQ4.0如何将投标文件或者招标文件转换为预算文件？",
			"levelId": "5",
			"type": 0,
			"qid": "260641"
		}],
		"isProfessional": 0,
		"hideUpDown": false,
		"resultType": 0,
		"initialQuestion": "GBQ",
		"cid": "eba7d442-5813-48fa-b13e-d13c2aa89a4f"
	},
	"pageCount": 3,
	"pageNumber": 1,
	"recordCount": 15,
	"pageSize": 5
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

请求成功返回的数据基本示例---人工监管 当前会话被人工监管了, pc端使用, h5/公众号/小程序暂时不用关注

    {
      "code": 200,
	  "message": "success",
	  "result": {
            "peerChatid": "weizp-a_1554342532589",
			"isDeal": 1
        } 
    }
1
2
3
4
5
6
7
8

请求失败返回的数据

请求失败返回数据基本示例 查看其它状态码

    {
        "code": 400,
		"message": "Required parameter 'chatid' is not present"
    }
    
		{
    	"code": 400,
    	"message": "matchedResult.channel: value must be between 1 and 6"
		}
	
		{
    	"code": 400,
    	"message": "matchedResult.question: Length exceeds the max value [500]"
		}
	
    {
        "code": 500,
		"message": "java.lang.ClassCastException"
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

# 根据算法匹配，获取答案V2

用户与机器人交互前，先调用算法匹配服务，使用户在输入问题后及时获取答案。

接口描述

  • 输入问题后点击发送或者直接回车进行提问，经过算法引擎，获得问题的答案。
  • 相比V1，新增表格知识问答（简单多轮对话）

请求

GET https://apigate.glodon.com/front/v2/matchedResult/get
1

请求header参数

参数 参数类型 参数约束 是否必传 示例值 描述
session-id 字符串 服务端返回,可从以下api中获取: - 开始新会话 - 会话超时，重启会话 否 C3D205E1B4C72BF451CDC326328786A5 索引用户信息的key

请求param参数

参数 参数类型 参数约束 是否必传 示例值 描述
robot 字符串 服务端获取 是 GCCP 机器人标识: 每次刚打开或者是切换机器人时, 从 获取机器人列表 接口获取
question 字符串 最大长度500 是 GBQ4如何使用 用户输入的问题
chatid 字符串 服务端获取 是 74139073-4cfd-449b -9479-7e2fb4895d4d 会话ID，同一会话ID可能包含多组问答, 从初始会话 开始新会话 api获取
channel 整型 1/2/3/4/5/6 是 2 1.PC 2.公众号 3.网站 4.个人微信 5.小程序 6.APP
isHot 布尔型 true/false 否 true PC端数据埋点使用
isPrevPage 布尔型 true/false 否 true PC端数据埋点使用
pageNumber 整型 整型 否 1 第几页，PC端进行引导回答换一批的时候使用,值从1开始
pageSize 整型 整型 否 5 每页数量（默认5）
routing 字符串 上一轮会话中获取 否 nlu/faq 用于区分后台调用的算法引擎（不传默认faq）
qid 整型 上一轮会话中获取 否 133256 表格问题中直推的标问ID，从上一轮表格问答中获取，当routing为nlu时传递
slotVecsState 字符串 上一轮会话中获取 否 None 算法引擎使用
slotsContent 字符串 上一轮会话中获取 否 None 算法引擎使用
slotsQueryTimes 字符串 上一轮会话中获取 否 None 算法引擎使用

请求成功返回的数据

请求成功返回数据字段描述

返回字段 类型 示例值 描述
answer 字符串 因为GBQ4.0软件在分部分项界面点的重用组价，只会自动复制过来分部分项的项 返回的答案
hideUpDown 布尔型 false 用于前端显示或隐藏点踩点赞页签
cid 字符串 2e604f02-29c5-4843-affd-533e0e497ee8 单条会话的唯一标识
initialQuestion 字符串 计价GBQ4如何下载 初始问题，用于问题学习
isProfessional 整型 0 1为非专业问题，0为专业问题
routing 字符串 nlu nlu/faq，用于后台区分调用的算法引擎
slotVecsState 字符串 None 算法引擎使用
slotsContent 字符串 None 算法引擎使用
slotsQueryTimes 字符串 None 算法引擎使用
resultType 整型 5 返回的数据结构类型,据此做不同的显示处理, 目前用于PC端埋点 ： - 0为引导问题 - 1为直推 - 2为引导后点击 - 3为未回答上 - 4为智能提示 - 5为闲聊 - 6为人工问题 - 7为直推下挂点击 - 8为表格问题
directQue 对象 返回字段类型示例值描述question字符串缀为GBQ4/GZB4/GTB4/GBG9/GPB9的文件要怎么打开问题htmlAnswer字符串首先打开软件，然后点击就可以了答案qid整型133256当前问题的唯一标识type整型2当前问题的类型 ： - 0为常规问题 - 1为人工问题 - 2为流程问题 - 3为表格问题 直推的数据(包括常规问题和表格问题),包含问题、答案、类型等相关信息
flowItem 对象 返回字段类型示例值描述id整型558流程项id, 用于获取下一个流程项isFirstItem布尔型true标识是不是第一个流程项, 用于控制是否显示标问 (只有第一个流程项的话才显示标问) - true: 是第一个流程项 - false: 不是第一个流程项flowName字符串第一步流程项名称flowContent字符串安装GBQ4流程项内容linkContent字符串下一步下一个流程项的链接入口, 点击能够展示出下一个流程项 流程问题的流程项（type=2） - 如果不是一个流程问题, 不返回该结构
similarQue 或 anotherQue 对象 返回字段类型示例值描述qid整型133256当前问题的唯一标识type整型2当前问题的类型 ： - 0为常规问题 - 1为人工问题 - 2为流程问题 - 3为表格问题question字符串缀为GBQ4文件要怎么打开问题 当前问题的相似问题列表 (其他字段后台使用，无需关注)

请求成功返回的数据基本示例----直推下挂 算法推出一条答案, 并返回三条相似的问题

{
	"code": 200,
	"message": "success",
	"result": {
		"similarQue": [{
			"question": "计价GBQ4.0重用组价，查询历史工程，全选自动复制组价为什么措施项目组价没有一起匹配过来？",
			"levelId": "5",
			"type": 0,
			"qid": "262189"
		}, {
			"question": "计价GBQ4.0如何返回项目管理界面？",
			"levelId": "5",
			"type": 0,
			"qid": "260847"
		}],
		"directQue": {
			"htmlAnswer": "<p>计价软件载入XML组价后，部分单位工程组价没有匹配进去是因为工程招标清单里面的部分单位工程清单编码和招标方给的招标控制价里面的清单编码不匹配。</p>",
			"question": "计价GBQ4.0项目管理界面载入XML组价后，部分单位工程组价并没有匹配进去",
			"type": 2,
			"qid": "262100",
			"flowItem": {//只有type=2才有
				"flowContent": "<p>测试1  </p>",
				"id": 483,
				"flowName": "测试1",
				"linkContent": "测试1",
				"isFirstItem": true
			}
		},
		"routing": "faq",
		"slotVecsState": "None",
		"slotsContent": "None",
		"slotsQueryTimes": "None",			
		"answer": "<p>计价软件载入组价</p>",
		"isProfessional": 0,
		"hideUpDown": false,
		"resultType": 1,
		"initialQuestion": "计价GBQ4.0项目管理界面载入XML组价后，部分单位工程组价并没有匹配进去",
		"cid": "aec5c6a6-f269-4f61-b19f-81759c49692a"
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

请求成功返回的数据基本示例---换一批提示/分页 算法没有找到正确答案, 返回五条提示的问题

{
	"code": 200,
	"message": "success",
	"result": {
		"anotherQue": [{
			"question": "计价GBQ4.0如何找回历史工程？",
			"levelId": "5",
			"type": 0,
			"qid": "260690"
		}, {
			"question": "计价GBQ4.0软件安装之后不显示图标/显示白色/没有生成Bin文件夹怎么处理？",
			"levelId": "5",
			"type": 0,
			"qid": "262034"
		}, {
			"question": "计价GBQ4.0软件没有锁如何查看工程的数据？",
			"levelId": "5",
			"type": 0,
			"qid": "262043"
		}, {
			"question": "计价GBQ4.0如何生成招标书/投标书？",
			"levelId": "5",
			"type": 0,
			"qid": "260762"
		}, {
			"question": "计价GBQ4.0如何将投标文件或者招标文件转换为预算文件？",
			"levelId": "5",
			"type": 0,
			"qid": "260641"
		}],
		"routing": "faq",
		"slotVecsState": "None",
		"slotsContent": "None",
		"slotsQueryTimes": "None",
		"isProfessional": 0,
		"hideUpDown": false,
		"resultType": 0,
		"initialQuestion": "GBQ",
		"cid": "eba7d442-5813-48fa-b13e-d13c2aa89a4f"
	},
	"pageCount": 3,
	"pageNumber": 1,
	"recordCount": 15,
	"pageSize": 5
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

请求成功返回的数据基本示例----表格问题 算法推出一条表格问题答案

{
	"code": 200,
	"message": "success",
	"result": {
		"directQue": {
			"htmlAnswer": "<p>计价软件载入XML组价后，部分单位工程组价没有匹配进去是因为工程招标清单里面的部分单位工程清单编码和招标方给的招标控制价里面的清单编码不匹配。</p>",
			"question": "计价GBQ4.0项目管理界面载入XML组价后，部分单位工程组价并没有匹配进去",
			"type": 3,
			"qid": "262100"
		},
		"routing": "nlu",
		"slotVecsState": "None",
		"slotsContent": "None",
		"slotsQueryTimes": "None",			
		"answer": "<p>计价软件载入组价</p>",
		"isProfessional": 0,
		"hideUpDown": false,
		"resultType": 1,
		"initialQuestion": "计价GBQ4.0项目管理界面载入XML组价后，部分单位工程组价并没有匹配进去",
		"cid": "aec5c6a6-f269-4f61-b19f-81759c49692a"
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

请求成功返回的数据基本示例---人工监管 当前会话被人工监管了, pc端使用, h5/公众号/小程序暂时不用关注

    {
      "code": 200,
	  "message": "success",
	  "result": {
            "peerChatid": "weizp-a_1554342532589",
			"isDeal": 1
        } 
    }
1
2
3
4
5
6
7
8

请求失败返回的数据

请求失败返回数据基本示例 查看其它状态码

    {
        "code": 400,
		"message": "Required parameter 'chatid' is not present"
    }
    
	{
    	"code": 400,
    	"message": "v2matchedResult.routing: 'xx' is invalid routing.valid routing must be in ('faq','nlu')"
	}
    
	{
    	"code": 400,
    	"message": "v2matchedResult.channel: value must be between 1 and 6"
	}
	
	{
    	"code": 400,
    	"message": "v2matchedResult.question: Length exceeds the max value [500]"
	}
	
    {
        "code": 500,
		"message": "java.lang.ClassCastException"
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# 根据问题id，获取答案

用户与机器人交互前，获取相关服务，使用户在提问后能够获取指定问题答案。

接口描述

  • 点击以下问题, 通过该接口返回答案 - 点击智能提示的问题 - 点击引导的问题 - 点击热门问题

请求

GET https://apigate.glodon.com/api/front/answer
1

请求header参数

参数 参数类型 参数约束 是否必传 示例值 描述
session-id 字符串 服务端返回,可从以下api中获取: - 开始新会话 - 会话超时，重启会话 否 C3D205E1B4C72BF451CDC326328786A5 索引用户信息的key

请求param参数

参数 参数类型 参数约束 是否必传 示例值 描述
qid 整型 服务端获取 是 133256 服务端返回的问题的标识,可从以下api中获取: - 获取Top热门问题 - 获取智能提示的问题 - 根据算法匹配，获取答案 - 根据算法匹配，获取答案V2
robot 字符串 服务端获取 是 GCCP 机器人标识: 每次刚打开或者是切换机器人时, 从 获取机器人列表 接口获取
clickQuestion 字符串 当前点击的问题 是 GBQ4如何使用 用户点击的问题
chatid 字符串 服务端获取 是 74139073-4cfd-449b -9479-7e2fb4895d4d 会话ID，同一会话ID可能包含多组问答, 从初始会话 开始新会话 api获取
clickType 整型 0/1/2/3 是 1 取值范围: - 0:智能提示点击 - 1:换一批引导问题点击 - 2:热门问题点击 - 3:直推下挂点击
channel 整型 1/2/3/4/5/6 是 2 1.PC 2.公众号 3.网站 4.个人微信 5.小程序 6.APP
initialQuestion 字符串 通过下图场景获取 否 GBQ4如何 初始问题（用于知识学习）, 不同的场景下获取的方式见下图

初始问题（用于知识学习）, 仅在以下两种情况传该参数，获取方式见下图

场景1-1:点击直推下引导的问题 场景1-2:点击换一批引导的问题
img img

请求成功返回的数据

请求成功返回字段描述

返回字段 类型 示例值 描述
cid 字符串 2e604f02-29c5-4843-affd-533e0e497ee8 单条会话的唯一标识
htmlAnswer 字符串 首先打开软件，然后点击就可以了 问题的答案(如果是流程问题, 不返回该字段，返回flowItem)
initialQuestion 字符串 计价GBQ4如何下载 初始问题，用于问题学习
routing 字符串 nlu nlu/faq，用于后台区分调用的算法引擎
qid 整型 133256 当前问题的唯一标识
slotVecsState 字符串 None 算法引擎使用
slotsContent 字符串 None 算法引擎使用
slotsQueryTimes 字符串 None 算法引擎使用
flowItem 对象 返回字段类型示例值描述id整型558流程项id, 用于获取下一个流程项isFirstItem布尔型true标识是不是第一个流程项,用于控制是否显示标问(只有第一个流程项的话才显示标问) - true: 是第一个流程项 - false: 不是第一个流程项flowName字符串第一步流程项名称flowContent字符串安装GBQ4流程项内容linkContent字符串下一步下一个流程项的链接入口, 点击能够展示出下一个流程项 流程问题的流程项（type=2） - 如果不是流程问题, 不返回该结构

请求成功返回的数据基本示例:标准问题

    {
		"code": 200,
		"message": "success",
        "result": {
        	"routing": "faq",
			"qid": 12345,
			"slotVecsState": "None",
			"slotsContent": "None",
			"slotsQueryTimes": "None",
            "cid ": "2e604f02-29c5-4843-affd-533e0e497ee8",
            "initialQuestion": "云计量只旋转图纸，不旋转构件",
            "htmlAnswer": "<p><span class='zc - highlight '>软件暂时不能处理。</span></p><p>，可以用柱代替布置。</p>"
        }   
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14

请求成功返回的数据基本示例:流程问题

    {
		"code": 200,
		"message": "success",
        "result": {
            "cid ": "2e604f02-29c5-4843-affd-533e0e497ee8",
            "initialQuestion": "云计量只旋转图纸，不旋转构件",
            "flowItem": {
           		"id": 558,
           		"isFirstItem": true,
           		"flowName": "第一步",
           		"flowContent": "<p>安装GBQ4</p>",
           		"linkContent": "下一步",
           	}			
        }   
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

请求失败返回的数据

请求失败返回的数据基本示例 查看其它状态码

   	{
        "code": 400,
		"message": "Required parameter 'qid' is not present"
   	}

	{
    	"code": 400,
    	"message": "answer.channel: value must be between 1 and 6"
	}
	
	{
    	"code": 400,
    	"message": "answer.qid: value must be a number"
	}
	
	{
    	"code": 400,
    	"message": "answer.clickType: value must be between 0 and 3"
	}

    {
        "code": 500,
		"message": "java.lang.NullPointerException"
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# 根据问题id，获取流程项

用户咨询流程性问题前，获取相关服务，使用户能够获取到指定流程问题的各个流程项。

接口描述

  • 点击流程问题下的流程链接, 根据流程id,获取下一个流程项

请求

GET https://apigate.glodon.com/api/front/flowItem
1

请求header参数

参数 参数类型 参数约束 是否必传 示例值 描述
session-id 字符串 服务端返回,可从以下api中获取: - 开始新会话 - 会话超时，重启会话 否 C3D205E1B4C72BF451CDC326328786A5 索引用户信息的key

请求param参数

参数 参数类型 参数约束 是否必传 示例值 描述
robot 字符串 服务端获取 是 GCCP 机器人标识: 每次刚打开或者是切换机器人时, 从 获取机器人列表 接口获取
chatid 字符串 服务端获取 是 74139073-4cfd-449b -9479-7e2fb4895d4d 会话ID，同一会话ID可能包含多组问答, 从初始会话 开始新会话 api获取
channel 整型 1/2/3/4/5/6 是 2 1.PC 2.公众号 3.网站 4.个人微信 5.小程序 6.APP
id 整型 服务端获取 是 1668 流程项ID，用于点击时查询下一个流程项, 从如下接口的返回结果中获取: - 获取Top热门问题 - 获取智能提示的问题 - 根据问题id，获取答案 - 根据算法匹配，获取答案 - 根据算法匹配，获取答案V2 - 根据问题id，获取关联问题答案

请求成功返回的数据

请求成功返回数据字段描述

返回字段 类型 示例值 描述
question 字符串 缀为GBQ4/GZB4/GTB4/GBG9/GPB9的文件要怎么打开 问题
initialQuestion 字符串 计价GBQ4如何下载 初始问题，用于问题学习
flowItem 对象 返回字段类型示例值描述id整型558流程项id, 用于获取下一个流程项flowName字符串第一步流程项名称flowContent字符串安装GBQ4流程项内容linkContent字符串下一步下一个流程项的链接入口, 点击能够展示出下一个流程项 流程问题的流程项（type=2）

请求成功返回的数据基本示例

{
	"code": 200,
	"message": "success",
	"result": {
		"flowItem": {
			"id": 480,
			"flowName": "2",
			"flowContent": "<p>2</p>",
			"linkContent": "2"
		},
		"question": "我要进行流程问题测试2",
		"initialQuestion": "我要进行流程问题测试2"
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

请求失败返回的数据

请求失败返回数据基本示例 查看其它状态码

   {
        "code": 400,
		"message": "Required parameter 'id' is not present"
    }

	{
    	"code": 400,
    	"message": "flowItem.id: value must be a number"
	}

	{
    	"code": 400,
    	"message": "flowItem.channel: value must be between 1 and 6"
	}

    {
        "code": 500,
		"message": "java.lang.NullPointerException"
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# 根据问题id，获取关联问题答案

在用户与机器人交互前，获取相关服务，使得用户可获得指定问题的关联问题答案。

接口描述

  • 点击关联问题，通过关联问题的id, 获取关联问题的答案

请求

GET https://apigate.glodon.com/api/front/linkQuestion
1

请求header参数

参数 参数类型 参数约束 是否必传 示例值 描述
session-id 字符串 服务端返回,可从以下api中获取: - 开始新会话 - 会话超时，重启会话 否 C3D205E1B4C72BF451CDC326328786A5 索引用户信息的key

请求param参数

参数 参数类型 参数约束 是否必传 示例值 描述
robot 字符串 服务端获取 是 GCCP 机器人标识: 每次刚打开或者是切换机器人时, 从 获取机器人列表 接口获取
chatid 字符串 服务端返回 是 74139073-4cfd-449b -9479-7e2fb4895d4d 会话ID，同一会话ID可能包含多组问答, 从初始会话 开始新会话 api获取
channel 整型 1/2/3/4/5/6 是 2 1.PC 2.公众号 3.网站 4.个人微信 5.小程序 6.APP
linkId 整型 关联的问题, 在答案结构中查找, 见下图: 是 155268 关联问题ID，用于点击时查询关联的问题, 从答案结构中提取
question 字符串 最大长度500 是 GBQ4如何使用 关联的问题, 在答案结构中查找, 见下图:
linkId 和 question 获取方式见下图:
img

请求成功返回的数据

请求成功返回数据字段描述

返回字段 类型 示例值 描述
htmlAnswer 字符串 首先打开软件，然后点击就可以了 答案 (如果是流程问题, 不返回该字段，返回flowItem)
hideUpDown 布尔型 false 用于前端显示或隐藏点踩点赞页签
question 字符串 计价GBQ4.0项目管理界面载入XML组价后，部分单位工程组价并没有匹配进去 问题
type 整型 2 当前问题的类型 ： - 0为常规问题 - 1为人工问题 - 2为流程问题 - 3为表格问题
cid 字符串 2e604f02-29c5-4843-affd-533e0e497ee8 单条会话的唯一标识
initialQuestion 字符串 计价GBQ4如何下载 初始问题，用于问题学习
routing 字符串 nlu nlu/faq，用于后台区分调用的算法引擎
qid 整型 133256 当前问题的唯一标识
slotVecsState 字符串 None 算法引擎使用
slotsContent 字符串 None 算法引擎使用
slotsQueryTimes 字符串 None 算法引擎使用
flowItem 对象 返回字段类型示例值描述id整型558流程项id, 用于获取下一个流程项isFirstItem布尔型true标识是不是第一个流程项, 用于控制是否显示标问 (只有第一个流程项的话才显示标问) - true: 是第一个流程项 - false: 不是第一个流程项flowName字符串第一步流程项名称flowContent字符串安装GBQ4流程项内容linkContent字符串下一步下一个流程项的链接入口, 点击能够展示出下一个流程项 流程问题的流程项（type=2） - 如果不是流程问题, 不返回该结构

请求成功返回的数据基本示例:常规问题

{
	"code": 200,
	"message": "success",
	"result": {
		"routing": "faq",
		"qid": 12345,
		"slotVecsState": "None",
		"slotsContent": "None",
		"slotsQueryTimes": "None",
		"htmlAnswer": "<p>计价软件载入XML组价后，部分单位工程组价没有匹配进去是因为工程招标清单里面的部分单位工程清单编码和招标方给的招标控制价里面的清单编码不匹配。</p>",
		"hideUpDown": false,
		"question": "计价GBQ4.0项目管理界面载入XML组价后，部分单位工程组价并没有匹配进去",
		"type": 0,
		"initialQuestion": "计价GBQ4.0项目管理界面载入XML组价后，部分单位工程组价并没有匹配进去",
		"cid": "0e7bf813-b138-4364-a16b-64eccbf63a3e"
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

请求成功返回的数据基本示例:流程问题

{
	"code": 200,
	"message": "success",
	"result": {
		"flowItem": {
			"id": 479,
			"flowContent": "<p>content1</p>",
			"flowName": "name1",
			"linkContent": "like1",
			"isFirstItem": true
		},
		"hideUpDown": false,
		"question": "我要进行流程问题测试2",
		"type": 2,
		"initialQuestion": "我要进行流程问题测试2",
		"cid": "58153881-ea83-42df-b4a2-09378a3aa660"
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

请求失败返回的数据

请求失败返回数据基本示例 查看其它状态码

    {
        "code": 400,
		"message": "Required parameter 'linkId' is not present"
    }
    
    {
    	"code": 400,
    	"message": "linkQuestion.linkId: value must be a number"
	}
    
    {
    	"code": 400,
    	"message": "linkQuestion.channel: value must be between 1 and 6"
	}

	{
    	"code": 400,
    	"message": "linkQuestion.question: Length exceeds the max value [500]"
	}

    {
        "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
20
21
22
23
24

← 人工监管功能相关服务 →

  • 在线客服

  • 意见反馈