16. 声网 API 16.3 我的视频通话列表【基础探测通过，待数据联调】

Table of Contents

16.3 我的视频通话列表【基础探测通过，待数据联调】

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

查询参数：

参数 类型 必填 说明
page integer 否 页码，默认 1
page_size integer 否 每页数量，默认 20，最大 100
booking_status integer 否 列表类型：1=待通话，包含真实预约状态 1=待通话、2=准备中、3=通话中；2=已完成，包含真实预约状态 4=已完成、5=艺人爽约、6=粉丝爽约、7=双方爽约、8=已取消；不传返回全部。该参数只表示页签类型，不表示真实预约状态
artist_id integer 否 偶像 ID
响应字段：
字段 类型 说明
items array 当前页数据列表
items[].booking_id integer 视频通话预约 ID
items[].booking_no string 视频通话预约编号
items[].room_no string 本地房间编号，APP 使用该参数作为统一入房接口 room_id 调用
items[].user_avatar string 用户头像
items[].artist_avatar string 艺人头像，严格读取独立维护的 tieup_artist.avatar；未配置时返回空字符串，不回退绑定账号的用户头像
items[].user_nickname string 用户昵称
items[].artist_nickname string 艺人昵称，优先取艺人名称，空时取艺人用户昵称
items[].scheduled_start_at string 预约开始时间
items[].scheduled_end_at string 预约结束时间
items[].duration_minutes integer 预约通话时长，单位分钟
items[].candy_amount integer 糖果消耗数量
items[].status integer 真实通话状态，不是 booking_status 页签值：1=待通话，2=准备中，3=通话中，4=已完成，5=艺人爽约，6=粉丝爽约，7=双方爽约，8=已取消
items[].status_label string 通话状态文案
items[].cancel_reason string 取消或异常原因，暂无原因时为空字符串
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",
        "user_avatar": "https://cdn.example.com/user.png",
        "artist_avatar": "https://cdn.example.com/artist.png",
        "user_nickname": "小糖",
        "artist_nickname": "星河",
        "scheduled_start_at": "2026-06-20 20:00:00",
        "scheduled_end_at": "2026-06-20 20:15:00",
        "duration_minutes": 15,
        "candy_amount": 300,
        "status": 1,
        "status_label": "待通话",
        "cancel_reason": ""
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 1,
      "next_cursor": null
    }
  }
}