Table of Contents
16.1 视频通话档位列表【基础探测通过,待数据联调】
GET /tieup/api/v1/video-call-plans
查询参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
artist_id |
integer | 是 | 艺人 ID;服务端按该艺人每分钟糖果单价计算所需糖果数量 |
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
plan_code |
string | 视频通话档位编码 |
plan_name |
string | 视频通话档位名称 |
duration_minutes |
integer | 通话时长,单位分钟 |
candy_amount |
integer | 按艺人每分钟糖果单价和通话时长计算出的所需糖果数量 |
interval_minutes |
integer | 预约间隔分钟数 |
config |
object/null | 档位扩展配置 |
响应示例:
{
"code": 200,
"message": "成功",
"data": [
{
"plan_code": "ten_minutes",
"plan_name": "10分钟通话",
"duration_minutes": 10,
"candy_amount": 60,
"interval_minutes": 15,
"config": {
"visible": true
}
}
]
}
说明:必须传入 artist_id;接口返回当前渠道/平台可用的视频通话档位列表,用于视频通话设置页档位卡片展示。前端通过 16.6 获取视频通话设置 返回的 video_call_plan_code 匹配并高亮当前选中档位。艺人未开启视频通话或每分钟糖果单价为 0 时仍返回档位列表,candy_amount 返回 0。tieup_video_call_plan 只维护时长和预约间隔,不再维护糖果数量;candy_amount 为接口按当前艺人每分钟糖果单价和档位时长实时计算的兼容展示字段,实际预约下单仍要求艺人已开启视频通话、已选择匹配档位且每分钟糖果单价大于 0。