Table of Contents
16.7 设置视频通话设置【未授权拦截通过,待登录态联调】
PUT /tieup/api/v1/artist/video-call-slots
请求体:
{
"video_call_enabled": 1,
"video_call_plan_code": "call_30m",
"available_time_slots": [
{
"weekday": 1,
"start_time": "19:00",
"end_time": "24:00"
}
]
}
关闭视频通话且保留原可预约时段时,可省略 available_time_slots:
{
"video_call_enabled": 2
}
请求参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
video_call_enabled |
integer | 否 | 是否开启视频通话:1=开启,2=关闭;不传则保持原值 |
video_call_plan_code |
string | 否 | 当前选择的视频通话档位编码;非空时必须是启用的视频通话档位;不传则保持原值 |
available_time_slots |
array | 条件必填 | video_call_enabled=2 时可省略;开启或未传开关时必传。包含 weekday、start_time、end_time |
保存到 tieup_artist_pricing.video_call_enabled、tieup_artist_pricing.video_call_plan_code 和 tieup_artist_pricing.available_time_slots。当显式传 video_call_enabled=2 且省略 available_time_slots 时,仅关闭视频通话并保留原可预约时段;显式传 available_time_slots: [] 时清空原时段。首次创建配置且关闭时省略该字段,时段保存为空数组。服务端校验视频通话档位是否存在且启用,并对已提交的可预约时段校验 JSON 结构、时间格式、同一天内开始时间小于结束时间和重叠冲突;end_time 可传 24:00 表示当天结束,不支持跨日时段,如需配置午夜后时段,应在对应星期单独配置 00:00-xx:xx。本接口暂不保存 video_call_price_per_minute,每分钟糖果单价仍由艺人定价设置维护;实际预约下单仍要求每分钟糖果单价大于 0。
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
artist_id |
integer | 艺人 ID |
video_call_enabled |
integer | 是否开启视频通话:1=开启,2=关闭 |
video_call_plan_code |
string | 当前选择的视频通话档位编码;未选择时为空字符串 |
available_time_slots |
array | 每周可预约时段列表 |
available_time_slots[].weekday |
integer | 星期几,1=周一 |
available_time_slots[].start_time |
string | 开始时间,格式 HH:mm,范围 00:00-23:59 |
available_time_slots[].end_time |
string | 结束时间,格式 HH:mm,范围 00:01-24:00;24:00 表示当天结束 |
响应示例:
{
"code": 200,
"message": "成功",
"data": {
"artist_id": 20001,
"video_call_enabled": 1,
"video_call_plan_code": "call_30m",
"available_time_slots": [
{
"weekday": 1,
"start_time": "20:00",
"end_time": "24:00"
},
{
"weekday": 6,
"start_time": "14:00",
"end_time": "18:00"
}
]
}
}