获取互动列表

获取 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	是	用户反馈。 ALL：全部。 NONE：无反馈。 GOOD：好评、喜欢、赞。 BAD：差评、不喜欢、倒。
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	错误详情