7.17.1 我的福利数量【已开发,待登录态联调】

GET /tieup/api/v1/me/benefits/count
Authorization: Bearer <access_token>

鉴权:需要 Authorization: Bearer <access_token>。接口无路径参数、查询参数和请求体,服务端按 Token 中的 current_identity 返回当前使用端对应的福利数量。

统计口径:

  • 粉丝身份只返回 redeemable_count。统计范围仅包含当前粉丝 tieup_subscription.status=1expires_at 晚于当前时间的有效订阅艺人,并按艺人去重。
  • 粉丝可兑换数量只统计当前上架、未软删除、库存充足、尚无待发放或已发放兑换记录,并且按历史累计订阅月数、提问数、视频通话分钟数或糖果消费数已经达标的福利。
  • 偶像身份只返回 pending_count。统计当前偶像全部 tieup_benefit_redemption.status=1 的待发放记录,关联福利后续下架或软删除仍计入。
  • 数量是查询时的实时入口提示。提交兑换和发放时仍以对应写接口的事务、库存、状态与归属校验结果为准。

粉丝身份完整响应示例:

{
  "code": 200,
  "message": "成功",
  "data": {
    "redeemable_count": 3
  }
}

偶像身份完整响应示例:

{
  "code": 200,
  "message": "成功",
  "data": {
    "pending_count": 2
  }
}

响应字段:

字段 类型 返回身份 说明
code integer 粉丝、偶像 业务响应码,成功为 200
message string 粉丝、偶像 响应信息,成功为 成功
data object 粉丝、偶像 当前身份对应的福利数量对象
data.redeemable_count integer 仅粉丝 当前有效订阅艺人下所有可兑换福利总数;无符合记录时返回 0
data.pending_count integer 仅偶像 当前偶像全部历史待发放福利总数;无符合记录时返回 0

错误响应:

HTTP/业务码 场景 说明
401 Token 缺失、无效或过期 返回统一鉴权失败响应
403 Token 选择偶像身份,但账号未开通偶像端或缺少艺人档案 返回 当前账号未开通偶像端