8. 偶像端 API 8.7 获取定价设置【基础探测通过，待数据联调】

Table of Contents

8.7 获取定价设置【基础探测通过，待数据联调】

GET /tieup/api/v1/artist/pricing

鉴权：需要 Authorization: Bearer <access_token>，且当前账号必须已开通偶像端。

响应字段：

字段 类型 说明
artist_id integer 当前登录账号对应的艺人 ID
subscription_plan_code string 当前选择的唯一订阅档位编码；未选择时为空字符串
subscription_plan object 当前请求渠道、平台和市场下的订阅档位详情；未选择、定价禁用或当前作用域不可用时返回 {}
subscription_plan.plan_code string 档位编码，等于 subscription_plan_code
subscription_plan.subscription_plan_code string 创建订阅订单使用的档位编码，与 plan_code 相同
subscription_plan.plan_name string 档位名称
subscription_plan.price_amount string 月费金额，单位元，固定两位小数
subscription_plan.duration_days integer 月费订阅有效天数
subscription_plan.annual_original_price_amount string 年费原价，单位元，固定两位小数
subscription_plan.annual_discount number/null 年度折扣，未配置年费时为 null
subscription_plan.annual_price_amount string/null 年费金额，单位元，固定两位小数
subscription_plan.ios_month_price_amount string/null iOS 月费展示金额，单位元
subscription_plan.ios_year_price_amount string/null iOS 年费展示金额，单位元
subscription_plan.auto_renew_methods object 月费、年费当前可用的自动续订渠道
subscription_plan.config object/null APP 展示扩展配置，不包含内部价格分字段和第三方资源 ID
video_call_plan_code string 当前视频通话档位编码；未配置时为空字符串
question_price integer 提问价格，单位糖果
video_call_price_per_minute integer 视频通话每分钟糖果单价
question_enabled integer 是否开启提问：1=开启，2=关闭
video_call_enabled integer 是否开启视频通话：1=开启，2=关闭
status integer 定价配置状态：1=启用，2=未配置/禁用

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "artist_id": 20001,
    "subscription_plan_code": "month_30",
    "subscription_plan": {
      "plan_code": "month_30",
      "subscription_plan_code": "month_30",
      "plan_name": "月度订阅",
      "price_amount": "30.00",
      "duration_days": 30,
      "annual_original_price_amount": "360.00",
      "annual_discount": 8,
      "annual_price_amount": "288.00",
      "ios_month_price_amount": "39.00",
      "ios_year_price_amount": "374.00",
      "auto_renew_methods": {"month": ["apple_iap"], "year": ["apple_iap"]},
      "config": {"visible": true, "annual_discount": 8, "annual_price_amount": "288.00"}
    },
    "video_call_plan_code": "ten_minutes",
    "question_price": 20,
    "video_call_price_per_minute": 6,
    "question_enabled": 1,
    "video_call_enabled": 1,
    "status": 1
  }
}

前端使用说明：

  • subscription_plan_code 是艺人当前唯一选择；GET /tieup/api/v1/subscription-plans?artist_id={artist_id} 返回当前请求作用域可选择的后台档位列表。
  • 后台艺人订阅配置只决定对应档位的自动续订资源是否可用，不替代艺人选择。