# 查询对话历史列表
#### 功能介绍
查询历史问题列表。包含对话ID、对话问题、用户名、对话开始时间。
#### URI
GET /v1/koosearch/chat-history
表1Query参数 
| 参数        | 是否必选 | 参数类型    | 描述                                                                                          |
|:---|:---|:---|:---|
| user_name | 否    | String  | 用户名。                                                                                        |
| repo_id   | 否    | String  | 知识库ID。 获取方式： 账号登录KooSearch体验平台，在左侧导航栏选择："知识库管理" ，在此界面获取"知识库ID"字段的值，表示该知识库在向量数据库中存储的ID，具有唯一性 |
| chat_id   | 否    | String  | 对话ID。                                                                                       |
| page_num  | 否    | Integer | 请求页码。                                                                                       |
| page_size | 否    | Integer | 请求限定响应结果的分页大小，例如5条/页，10条/页。                                                                 |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                           |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 接口鉴权使用的Token，Token获取方式参考：3.2节 认证鉴权。 **约束限制：** 不涉及。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数                 | 参数类型                                                                                          | 描述        |
|:---|:---|:---|
| total              | Integer                                                                                       | 会话历史总数。   |
| size               | Integer                                                                                       | 当前页面返回条数。 |
| pages              | Integer                                                                                       | 总页数。      |
| current            | Integer                                                                                       | 当前页码。     |
| optimize_count_sql | Boolean                                                                                       | 当前无实际意义。  |
| search_count       | Boolean                                                                                       | 当前无实际意义。  |
| records            | Array of [ChatHistoryRecordInfo] objects | 会话历史详情。   |
   
 表4ChatHistoryRecordInfo 
| 参数                | 参数类型    | 描述                                                                  |
|:---|:---|:---|
| chat_id           | String  | 会话ID，会话的唯一标识。                                                       |
| knowledge_repo_id | String  | 知识库ID，标识当前会话参考的知识库。                                                 |
| slave_repo_id     | String  | 从知识库ID。                                                             |
| chat_title        | String  | 当前会话中的query。                                                        |
| create_date_time  | String  | 会话发生的时间戳。                                                           |
| project_id        | String  | 项目ID，1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。预留字段，可联系负责开通服务的工作人员获取该字段的值。 |
| is_del            | Integer | 当前对话是否删除标记，0：未删除，1：已删除。                                             |
   
#### 请求示例
无
#### 响应示例
**状态码：200**
返回成功。
```
{
  "records" : [ {
    "chat_id" : "8080de56-be09-4e80-a9e3-efe1e0505d16",
    "knowledge_repo_id" : "d848a560-6c71-4c87-ab3f-8b6e63ebbe62",
    "chat_title" : "安全保护机制测试",
    "create_date_time" : "1731052459260",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0,
    "slave_repo_id" : "09d83dce-4379-47d6-8753-c0fb76c360a3,f4b45b6c-1331-411c-9d0a-adfc8a55877b"
  }, {
    "chat_id" : "0c11fab3-2a9e-4ceb-842b-178ae21b302d",
    "knowledge_repo_id" : "d848a560-6c71-4c87-ab3f-8b6e63ebbe62",
    "chat_title" : "球兰和心叶球兰有什么区别",
    "create_date_time" : "1731051914932",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "bb7fbd8a-ec5a-4d23-a6f3-0188d2b34377",
    "knowledge_repo_id" : "d848a560-6c71-4c87-ab3f-8b6e63ebbe62",
    "chat_title" : "介绍一下生石花",
    "create_date_time" : "1731050885407",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "188eaa84-c09a-46a5-bade-f6301a9b3046",
    "knowledge_repo_id" : "d848a560-6c71-4c87-ab3f-8b6e63ebbe62",
    "chat_title" : "什么是多肉植物",
    "create_date_time" : "1731050363161",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "f939c01e-8042-49bb-b207-6575f98bbaeb",
    "knowledge_repo_id" : "acd90739-2e22-4870-b2db-35018699b623",
    "chat_title" : "发动机故障有哪些？",
    "create_date_time" : "1731049696207",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "fb12825c-1f93-487e-b5ef-e03f711a4219",
    "knowledge_repo_id" : "09d83dce-4379-47d6-8753-c0fb76c360a3",
    "chat_title" : "《Development and Analysis of Fast-Charging Model of Electric Vehicles》内容概要是怎样的?",
    "create_date_time" : "1731049167914",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "b267029c-9081-421d-8df2-36941a35f167",
    "knowledge_repo_id" : "09d83dce-4379-47d6-8753-c0fb76c360a3",
    "chat_title" : "《Development and Analysis of Fast-Charging Model of Electric Vehicles》内容概要是怎样的?",
    "create_date_time" : "1731049057770",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "ea64df7f-2a43-4158-a502-d74bcf438ab6",
    "knowledge_repo_id" : "09d83dce-4379-47d6-8753-c0fb76c360a3",
    "chat_title" : "中国纯电动乘用车续驶里程和能耗评价是依据什么标准",
    "create_date_time" : "1731048963883",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "0227a870-8713-4a09-9253-2347d715bcd6",
    "knowledge_repo_id" : "09d83dce-4379-47d6-8753-c0fb76c360a3",
    "chat_title" : "中国纯电动乘用车续驶里程和能耗评价是依据什么标准",
    "create_date_time" : "1731048945303",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  }, {
    "chat_id" : "bb5e22ca-42a0-453a-aef7-776ecc937eb0",
    "knowledge_repo_id" : "09d83dce-4379-47d6-8753-c0fb76c360a3",
    "chat_title" : "中国纯电动乘用车续驶里程和能耗评价是依据什么标准",
    "create_date_time" : "1731048825929",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "is_del" : 0
  } ],
  "total" : 40798,
  "size" : 10,
  "current" : 1,
  "pages" : 4080
}
```
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 200 | 返回成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。