16. 声网 API 16.1.1 视频通话可预约时间列表【待联调】

Table of Contents

16.1.1 视频通话可预约时间列表【待联调】

GET /tieup/api/v1/artists/{artist_id}/video-call-available-slots

路径参数：

参数 类型 必填 说明
artist_id integer 是 艺人 ID

查询参数：

参数 类型 必填 说明
start_date string 否 开始日期，格式 Y-m-d，默认今天；不能早于今天
days integer 否 返回天数，默认 7，最大 30

响应字段：

字段 类型 说明
artist_id integer 艺人 ID
start_date string 本次查询开始日期
days integer 本次查询天数
video_call_plan_code string 当前艺人启用的视频通话档位编码
duration_minutes integer 单次通话时长，单位分钟
interval_minutes integer 两个可预约格子之间的休息间隔，单位分钟
price_candy_per_minute integer 当前艺人视频通话每分钟糖果单价
slot_candy_amount integer 当前档位每个完整时段需要消耗的糖果数量
items array 按日期分组的可预约格子
items[].date string 日期
items[].weekday integer 星期几，1=周一
items[].slots array 当天可展示的时间格子
items[].slots[].start_at string 格子开始时间
items[].slots[].end_at string 格子结束时间
items[].slots[].price_candy_per_minute integer 当前格子的每分钟糖果单价
items[].slots[].candy_amount integer 预约该格子需要消耗的糖果数量
items[].slots[].status string 格子状态：available=可预约，booked=已被占用
items[].slots[].is_available boolean 是否可预约
items[].slots[].unavailable_reason string 不可预约原因；可预约时为空字符串，已占用时为 booked

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "artist_id": 20001,
    "start_date": "2026-06-20",
    "days": 7,
    "video_call_plan_code": "call_30m",
    "duration_minutes": 30,
    "interval_minutes": 10,
    "price_candy_per_minute": 1,
    "slot_candy_amount": 30,
    "items": [
      {
        "date": "2026-06-20",
        "weekday": 6,
        "slots": [
          {
            "start_at": "2026-06-20 10:00:00",
            "end_at": "2026-06-20 10:30:00",
            "price_candy_per_minute": 1,
            "candy_amount": 30,
            "status": "available",
            "is_available": true,
            "unavailable_reason": ""
          },
          {
            "start_at": "2026-06-20 10:40:00",
            "end_at": "2026-06-20 11:10:00",
            "price_candy_per_minute": 1,
            "candy_amount": 30,
            "status": "booked",
            "is_available": false,
            "unavailable_reason": "booked"
          }
        ]
      }
    ]
  }
}

未开通视频通话服务响应（HTTP 422）：

{
  "code": 422,
  "message": "该偶像未开通视频通话服务",
  "data": []
}

触发条件：艺人视频通话开关未开启，或艺人尚未选择视频通话档位。创建视频通话预约接口遇到相同状态时也返回上述提示。

业务规则：

  • 可预约格子不落库，由服务端按当前艺人每周可预约时段、通话档位 duration_minutes 和 interval_minutes 实时生成。
  • 只返回完整满足通话时长的格子；尾部不足一个完整通话时长的时间不返回。
  • 跨天配置按配置日归属展开，例如周三 22:00-05:00 会生成周三夜间到周四凌晨的格子。
  • 已预约订单按创建时保存的 scheduled_start_at 和 scheduled_end_at 永久有效；艺人后续修改工作时间不会反向取消旧预约。
  • 只要已有待通话、准备中或通话中的预约与格子区间存在重叠，该格子就返回 booked；旧预约因工作时间修改导致格子错位时，会占用所有重叠的新格子。