16. 声网 API 16.8 偶像视频通话预约列表【基础探测通过，待数据联调】

Table of Contents

16.8 偶像视频通话预约列表【基础探测通过，待数据联调】

GET /tieup/api/v1/artist/video-call-bookings

查询参数：

参数 类型 必填 说明
page integer 否 页码，默认 1
page_size integer 否 每页数量，默认 20
booking_status integer 否 列表类型：1=待通话，包含状态 1=待通话、2=准备中、3=通话中；2=已完成，包含状态 4=已完成、5=艺人爽约、6=粉丝爽约、7=双方爽约、8=已取消；不传返回全部。响应 items[].status 仍返回真实预约状态

响应字段：

字段 类型 说明
items array 当前页数据列表
items[].booking_id integer 视频通话预约 ID
items[].booking_no string 视频通话预约编号
items[].room_no string 本地房间编号，APP 使用该参数作为统一入房接口 room_id 调用
items[].fan_user_id integer 粉丝用户 ID
items[].avatar string 卡片展示头像，取粉丝头像
items[].nickname string 卡片展示昵称，取粉丝昵称
items[].scheduled_start_at string 预约开始时间
items[].scheduled_end_at string 预约结束时间
items[].status integer 通话状态：1=待通话，2=准备中，3=通话中，4=已完成，5=艺人爽约，6=粉丝爽约，7=双方爽约，8=已取消
items[].status_label string 通话状态文案
items[].duration_minutes integer 预约通话时长，单位分钟
items[].candy_amount integer 本次预约消耗糖果数
pagination.page integer 当前页码
pagination.page_size integer 每页数量
pagination.total integer 总数量
pagination.next_cursor string/null 下一页游标，当前页码分页场景返回 null

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "items": [
      {
        "booking_id": 40001,
        "booking_no": "VC202606170001",
        "room_no": "VR2026061719590012345678",
        "fan_user_id": 10001,
        "avatar": "https://cdn.example.com/user.png",
        "nickname": "小糖",
        "scheduled_start_at": "2026-06-20 20:00:00",
        "scheduled_end_at": "2026-06-20 20:10:00",
        "status": 1,
        "status_label": "待通话",
        "duration_minutes": 10,
        "candy_amount": 50
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 1,
      "next_cursor": null
    }
  }
}