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 返回 0tieup_video_call_plan 只维护时长和预约间隔,不再维护糖果数量;candy_amount 为接口按当前艺人每分钟糖果单价和档位时长实时计算的兼容展示字段,实际预约下单仍要求艺人已开启视频通话、已选择匹配档位且每分钟糖果单价大于 0