接口说明
查询指定智能体的会话列表。
基础信息
| 请求方式 | 请求地址 |
| GET | https://api.helpbots.ai/api/chats/conversation-list |
请求参数
Header
| 参数名 |
取值
|
说明 |
|---|---|---|
| x-api-key | $apikey |
用于验证客户端身份的访问令牌。你可以在后台生成访问令牌，详细信息，参考获取api key |
Query params
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | int | 是 |
查询会话对应的智能体ID |
| conversation_type | string | 否 |
查询会话的类型 会话类型: DEBUG、API、SDK 不传返回全部类型 |
| page | int | 否 |
分页查询时的页码 默认为1 |
| pagesize | int | 否 |
分页大小 默认为20 |
示例
请求示例
curl --location --request GET 'https://api.helpbots.ai/api/chats/conversation-list?id=18&page=1&pagesize=20' \
--header 'x-api-key: yourapikey' \响应示例
{
"data": {
"list": [
{
"conversation_id": "do19exkxdk0zd5tr********", #会话ID
"conversation_type":"API", #会话类型
"add_time": "1745741991" #创建会话时间
},
{
"conversation_id": "yy8rrpbivj7ld2a6********",
"conversation_type":"DEBUG",
"add_time": "1745571788"
}
],
"total": 2,
"page": 1,
"page_size": 20
},
"msg": "Success",
"code": 200
}