获取互动列表
最新更新:

获取互动列表

获取 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 错误详情