8. 偶像端 API 8.12 偶像提问列表【基础探测通过，待数据联调】

Table of Contents

8.12 偶像提问列表【基础探测通过，待数据联调】

GET /tieup/api/v1/artist/questions

鉴权：需要 Authorization: Bearer <access_token>，且当前账号已开通偶像端。

查询参数：

参数 类型 必填 说明
status integer 否 按会话链最新一条问题/追问筛选：1=待回答，2=已回答，3=已拒绝，4=已退款，5=已取消
fan_user_id integer 否 粉丝用户 ID

响应字段：

字段 类型 说明
items array 当前页会话链列表，一条记录对应一条“提问-回答-追问”链
items[].id integer 会话链最新问题/追问 ID，偶像回答时使用该 ID
items[].status integer 会话链最新问题/追问状态：1=待回答，2=已回答，3=已拒绝，4=已退款，5=已取消
items[].fan_nickname string 粉丝昵称
items[].fan_avatar string 粉丝头像 URL
items[].fan_user_id integer 粉丝用户 ID
items[].question_no string 提问编号
items[].parent_question_id integer/null 上一条问题 ID；主问题为空，追问指向上一条已回答问题
items[].root_question_id integer 会话链根问题 ID
items[].business_type string 业务类型：question=付费提问，follow_up_question=追问
items[].question_content string 提问内容
items[].created_at string/null 创建时间
items[].price_candy_amount string 本次提问/追问消耗糖果数量
items[].thread_items array 精简问答链，按提问、回答、追问、回答顺序排列
items[].thread_items[].id integer 链路条目问题/追问 ID
items[].thread_items[].fan_nickname string 粉丝昵称
items[].thread_items[].fan_avatar string 粉丝头像 URL
items[].thread_items[].fan_user_id integer 粉丝用户 ID
items[].thread_items[].status integer 链路条目状态
items[].thread_items[].business_type string 业务类型：question=付费提问，follow_up_question=追问
items[].thread_items[].question_content string 提问或追问内容
items[].thread_items[].answer_content string/null 回答内容，未回答为空
items[].thread_items[].answered_at string/null 回答时间，未回答为空
items[].thread_items[].created_at string/null 创建时间
items[].thread_items[].price_candy_amount string 本条提问/追问消耗糖果数量
pagination object 分页信息
pagination.page integer 当前页码
pagination.page_size integer 每页数量
pagination.total integer 当前筛选条件下的会话链总数量；status=2 且未传 fan_user_id 时与偶像计总的 answered_question_count 一致
pagination.next_cursor string/null 游标分页预留字段，当前为空

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "items": [
      {
        "id": 50002,
        "status": 1,
        "fan_nickname": "Tieup用户",
        "fan_avatar": "https://cdn.example.com/avatar.png",
        "fan_user_id": 10001,
        "question_no": "Q202606170002",
        "parent_question_id": 50001,
        "root_question_id": 50001,
        "business_type": "follow_up_question",
        "question_content": "还想了解每天练习多久",
        "created_at": "2026-06-17 10:05:00",
        "price_candy_amount": "50.00",
        "thread_items": [
          {
            "id": 50001,
            "fan_nickname": "Tieup用户",
            "fan_avatar": "https://cdn.example.com/avatar.png",
            "fan_user_id": 10001,
            "status": 2,
            "business_type": "question",
            "question_content": "可以分享练习建议吗？",
            "answer_content": "建议先从 20 分钟基础练习开始",
            "answered_at": "2026-06-17 10:03:00",
            "created_at": "2026-06-17 10:00:00",
            "price_candy_amount": "20.00"
          },
          {
            "id": 50002,
            "fan_nickname": "Tieup用户",
            "fan_avatar": "https://cdn.example.com/avatar.png",
            "fan_user_id": 10001,
            "status": 1,
            "business_type": "follow_up_question",
            "question_content": "还想了解每天练习多久",
            "answer_content": null,
            "answered_at": null,
            "created_at": "2026-06-17 10:05:00",
            "price_candy_amount": "50.00"
          }
        ]
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 1,
      "next_cursor": null
    }
  }
}

说明：仅返回当前偶像自己的提问会话链。列表按会话链分页，顶层字段表示最新一条问题/追问，thread_items 返回精简上下文。