获取互动列表
最新更新:
获取互动列表
获取 Bot 聊天记录内的 Q&A 列表。
请求方式
GET
调用地址
https://api.gptbots.ai/v1/message/qa/record/page
调用验证
详情参见 API 概述的鉴权方式说明。
请求
请求示例
curl --location 'https://api.gptbots.ai/v1/message/qa/record/page?page=1&page_size=10&start_time=1732982400000&end_time=1735660799999&user_feedback=ALL' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'
curl --location 'https://api.gptbots.ai/v1/message/qa/record/page?page=1&page_size=10&start_time=1732982400000&end_time=1735660799999&user_feedback=ALL' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'
此代碼塊在浮窗中顯示
请求头
字段 | 类型 | 描述 |
---|---|---|
Authorization | Bearer ${token} | 使用 Authorization: Bearer ${token}进行调用验证,请在 API 密钥页面获取密钥作为 token。 |
Content-Type | application/json | 数据类型,取值为 application/json。 |
请求体
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
user_feedback | String | 是 | 用户反馈。 |
start_time | Long | 是 | 查询范围的开始时间,时间戳。查询对象是 QA 中问题(Q)的时间。 |
end_time | Long | 是 | 查询范围的结束时间,时间戳。查询对象是 QA 中问题(Q)的时间。 |
page | Integer | 是 | 页码,从 1 开始。 |
page_size | Integer | 是 | 每页的文档数。填写范围 10-100。 |
响应
响应示例
{
"qa": [
{
"id": "xxxxxx",
"q_time": 1699891200,
"q": "xxxxxx",
"a": "xxxxxx",
"user_feedback": "GOOD",
"convo_id": "xxxxxx",
"convo_type": "API",
"aid": "xxxxxx",
"user_id": "xxxxxx"
},
{
"id": "xxxxxx",
"q_time": 1699891214,
"q": "xxxxxx",
"a": "xxxxxx",
"user_feedback": "BAD",
"convo_id": "xxxxxx",
"convo_type": "API",
"aid": "xxxxxx",
"user_id": "xxxxxx"
}
]
}
{
"qa": [
{
"id": "xxxxxx",
"q_time": 1699891200,
"q": "xxxxxx",
"a": "xxxxxx",
"user_feedback": "GOOD",
"convo_id": "xxxxxx",
"convo_type": "API",
"aid": "xxxxxx",
"user_id": "xxxxxx"
},
{
"id": "xxxxxx",
"q_time": 1699891214,
"q": "xxxxxx",
"a": "xxxxxx",
"user_feedback": "BAD",
"convo_id": "xxxxxx",
"convo_type": "API",
"aid": "xxxxxx",
"user_id": "xxxxxx"
}
]
}
此代碼塊在浮窗中顯示
成功响应
字段名 | 类型 | 说明 |
---|---|---|
qa | Array | Q&A 列表。 |
id | String | Q&A 的 ID。 |
q_time | Long | 问题(Q)的发出时间,时间戳。 |
q | String | 问题内容。 |
a | String | 回答内容。 |
user_feedback | String | 用户反馈。 |
convo_id | String | 所属的对话的 ID。 |
convo_type | String | 所属的对话的类型。 |
user_id | String | 用户 ID。Bot 开发者通过第三方手段,为用户自定义标记的 ID,用于定位用户的具体身份。 |
失败响应
字段 | 类型 | 描述 |
---|---|---|
code | int | 错误码 |
message | string | 错误详情 |