# 机器人&知识库

{
    "item": {
        "token": "4ac37cb2e9c740dba4b75a34d5358802",
        "expires_in": "86400"
    },
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

{
   "items": [],
   "item": {
       "robot_flag": 1,
       "question_id": "078726f1435b4218b9733afe2433b9fe",
       "link_question_num": 4,
       "link_question_list": [
           {
               "sort_no": 1,
               "match_flag": 0,
               "docid": "1b06cc8839574dc487bf658f0033bfb1",
               "guide_question_disname": "违约金/滞纳金是否可以开具发票？",
               "guide_question": "违约金/滞纳金是否可以开具发票？"
           },
           {
               "sort_no": 4,
               "match_flag": 0,
               "docid": "9b66fd499ff946df8213868bece0b0e3",
               "guide_question_disname": "北京有按天收费的房子么",
               "guide_question": "北京有按天收费的房子么"
           }
       ],
       "companyid": "0a53403cb9b34d528bdc11df69c283ff",
       "guide_strip": "<p>测试引导语！！！</p>"
   },
   "ret_code": "000000",
   "ret_msg": "查询成功！"
}

  单轮：传入用户问题；
  多轮：需要根据上轮返回值中multiDiaRespInfo字段确定传入内容。
	multiDiaRespInfo中关键字段为：interfaceList和inputContent，同一轮返回值中两者只会存在一个。
	1）如果上轮返回interfaceList,只保留template和interfaceRetList的json，其中interfaceRetList集合只保留选中的集合元素，例：
```json
		上轮返回：{
					"template":0,
					"question":"模板一",
					"level":0,
					"conversationId":"5fcb4cb5-2078-41c7-bb9d-8fbf57464c94",
					"docId":"1b8b2dcc4a8243649fa49744b9cf362b",
					"groupId":"9a38730078354d4a832a6c621483ad9d",
					"remindQuestion":"请选择电影:",
					"endFlag":false,
					"levelName":"电影",
					"retCode":"000000",
					"clickFlag":1,
					"interfaceRetList":[
						{
							"summary":"好看的电影，不要错过",
							"thumbnail":"",
							"anchor":"http://www.baidu.com",
							"movieId":"1",
							"tag":"2020年上映",
							"label":"20.01元",
							"title":"变形金刚III"
						},
						{
							"summary":"优秀电影",
							"thumbnail":"https://i01.lw.aliimg.com/media/lADODuM9KM0E2s0E1w_1239_1242.jpg",
							"anchor":"http://www.sina.com",
							"movieId":"3",
							"tag":"未上映",
							"label":"60.00",
							"title":"猩球崛起"
						}
					],
					"outPutParamList":"title#movieId"
				}
			客户选中title为"变形金刚III"的选项，则传入数据为：{
					"template":0,					
					"interfaceRetList":[
						{
							"summary":"好看的电影，不要错过",
							"thumbnail":"",
							"anchor":"http://www.baidu.com",
							"movieId":"1",
							"tag":"2020年上映",
							"label":"20.01元",
							"title":"变形金刚III"
						}
					]
				}

		例：{
				"template":0,
				"question":"我想买手机",
				"level":0,
				"conversationId":"a4bb45ed-594e-4953-b74e-e2f902f1337f",
				"docId":"022e96da2f8346b7bfb0efb400a9c558",
				"groupId":"9a38730078354d4a832a6c621483ad9d",
				"remindQuestion":"请选择品牌",
				"endFlag":false,
				"levelName":"品牌",
				"retCode":"000000",
				"inputContentList":"华为,苹果,小米",
				"outPutParamList":"品牌"
			}
		选中inputContentList里的华为，则传入数据为：华为；

		上轮返回：{
					"template":0,
					"question":"模板一",
					"level":0,
					"conversationId":"5fcb4cb5-2078-41c7-bb9d-8fbf57464c94",
					"docId":"1b8b2dcc4a8243649fa49744b9cf362b",
					"groupId":"9a38730078354d4a832a6c621483ad9d",
					"remindQuestion":"请选择电影:",
					"endFlag":false,
					"levelName":"电影",
					"retCode":"000000",
					"clickFlag":1,
					"interfaceRetList":[
						{
							"summary":"好看的电影，不要错过",
							"thumbnail":"",
							"anchor":"http://www.baidu.com",
							"movieId":"1",
							"tag":"2020年上映",
							"label":"20.01元",
							"title":"变形金刚III"
						},
						{
							"summary":"优秀电影",
							"thumbnail":"https://i01.lw.aliimg.com/media/lADODuM9KM0E2s0E1w_1239_1242.jpg",
							"anchor":"http://www.sina.com",
							"movieId":"3",
							"tag":"未上映",
							"label":"60.00",
							"title":"猩球崛起"
						}
					],
					"outPutParamList":"title#movieId"
				}

			客户选中title为"变形金刚III"的选项，则传入数据为：{
					"level":0,
					"conversationId":"5fcb4cb5-2078-41c7-bb9d-8fbf57464c94",				
					"movieId":"1",
					"title":"变形金刚III"
				}

		例：{
				"template":0,
				"question":"我想买手机",
				"level":0,
				"conversationId":"a4bb45ed-594e-4953-b74e-e2f902f1337f",
				"docId":"022e96da2f8346b7bfb0efb400a9c558",
				"groupId":"9a38730078354d4a832a6c621483ad9d",
				"remindQuestion":"请选择品牌",
				"endFlag":false,
				"levelName":"品牌",
				"retCode":"000000",
				"inputContentList":"华为,苹果,小米",
				"outPutParamList":"品牌"
			}
		选中inputContentList里的华为，则传入数据为：{
				"level":0,
				"conversationId":"a4bb45ed-594e-4953-b74e-e2f902f1337f",
				"品牌":"华为"
				} 
				

{
    "item":{
        "answer":"xx",
        "suggestions":[
            {
            	"question":"xx",
            	"answer":"xx",
            	"docid":"xx"
            }
        ],
        "question":"xx",
        "docid":"xx",
        "userid":"xx",
        "cid":"xx",
        "msgid":"xx",
        "stripe":"xx",
        "robot_flag":"1",
        "answer_type":"1",
        "session_new":"true",
        "transfer_type":"1"
    },
    "ret_code":"000000",
    "ret_msg":"成功"
}

{
    "item": {
        "ustatus": "-1"
    },
    "ret_code": "000000",
    "ret_msg": "成功"
}

{
	"items" : [
		{
			"all_type_name" : "xx",
			"answer_desc" : "xx",
			"answer_flag" : "1",
			"answerid" : "xx",
			"answer_img" : "xx",
			"answer_txt" : "xx",
			"audit_status" : "1",
			"companyid" : "xx",
			"docid" : "xx",
			"effect_time" : "1481731200",
			"invalid_time" : "4102415999",
			"link_flag" : "1",
			"match_flag" : "0",
			"questionid" : "xx",
			"question_title" : "xx",
			"question_typeid" : "xx",
			"question_type_name" : "xx",
			"robot_flag" : "1",
			"smail_question_num" : "0",
			"updateid" : "xx",
			"update_time" : "1481789852",
			"used_flag" : "0"
		} 
	],
	"page_count" : "3",
	"page_no" : "1",
	"page_size" : "15",
	"total_count" : "40",
	"ret_code":"000000",
	"ret_msg":"操作成功"
}

{
	"items" : [
		{
			"companyid" : "xx",
			"parent_typeid" : "xx",
			"question_typeid" : "xx",
			"question_type_name" : "xx",
			"type_level" : "1",
			"last" : "true",
			"type_flag" : "1"
		} 
	],
    "ret_code":"000000",
    "ret_msg":"操作成功"
}

{
	"item" : {
		"answer_desc" : "xx",
		"answer_flag" : 1,
		"answerid" : "xx",
		"answer_img" : "xx",
		"answer_txt" : "xx",
		"answer_summary" : "xx",
		"audit_status" : "1",
		"companyid" : "xx",
		"docid" : "xx",
		"create_time" : "2017-01-01 08:00:00",
		"effect_time" : "2017-01-01",
		"link_question_list" : [
			{
				"docid" : "xx",
				"link_name" : "xx",
				"link_question_title" : "xx"
			}
		],
		"link_question_num" : "2",
		"linked_flag" : "1",
		"match_flag" : "0",
		"questionid" : "xx",
		"question_title" : "xx",
		"question_typeid" : "xx",
		"question_type_name" : "xx",
		"robot_flag" : "1",
		"smail_question_num" : "0",
		"updateid" : "xx",
		"update_time" : "2017-01-01 08:00:00",
		"used_flag" : "0"
	},
	"ret_code":"000000",
    "ret_msg":"操作成功"
}

{       
	"ret_code": "000000",
	"ret_msg": "操作成功！",
	"item": "xxxxx"
}

{
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

{
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

{
    "code": "000000", // '000000'表示成功 
    "robotMsg": "机器人消息", //如传入，将替代界面配置的「机器人提问引导」「答案引导文案」。可以在文案中加入“\n”实现换行效果（限新版PC/H5（接入url含“V2”）、2.8.2及以上版本SDK）。注意，模板类型，模板类型选择「不选模板」时，请将机器人发送的文本内容通过下面的"title"参数传输 
    "list": [
        {
            "id": "参数ID",
            "title": "标题", //必须返回参数 。 模板类型选择「不选模板」时，请将机器人发送的文本内容通过本参数传输 
            "summary": "摘要",
            "tag": "标签 （可显示多个项）",
            " label": "价格||评分||多少人想看||人数等一切非多个标签的展示项",
            "thumbnail": "预览图片地址",
            "anchor": "点击跳转地址",
        },
        {
            "id": "参数ID",
            "title": "标题",
            "summary": "摘要",
            "tag": "标签 （可显示多个项）",
            " label": "价格||评分||多少人想看||人数等一切非多个标签的展示项",
            "thumbnail": "预览图片地址",
            "anchor": "点击跳转地址"
        }
    ]
}

{
    "code": "000001", // '000001'表示接口返回自定义异常提示信息 
    "errorMsg": "异常信息描述" //机器人展示内容 
}

{
    "code": "000000 '000000代表成功'",
    "list": [
        {
            "title": "北京",
            "cityId": "1" //城市 ID 
        },
        {
            "title": "上海",
            "cityId": "2" //城市 ID 
        }
    ]
}

{
    "ret_code": 0,
    "ret_message": "今天是星期3，农历二月初四，现在温度为：5℃，湿度为：12，风向为：北风，风力为：3级。"   
}