7. 粉丝端 API 7.16 我的福利偶像列表【基础探测通过，待数据联调】

Table of Contents

7.16 我的福利偶像列表【基础探测通过，待数据联调】

GET /tieup/api/v1/me/benefit-artists

鉴权：需要 Authorization: Bearer <access_token>。

说明：返回粉丝已订阅过且当前存在上架福利的偶像列表，附带每个偶像的可兑换数和已兑换数。

查询参数：

参数 类型 必填 说明
page integer 否 页码，默认 1
page_size integer 否 每页数量，默认 20

响应字段：

字段 类型 说明
items array 偶像列表
items[].artist_id integer 艺人 ID
items[].artist_name string 艺人名称
items[].artist_avatar string 艺人头像，严格读取独立维护的 tieup_artist.avatar；未配置时返回空字符串，不回退绑定账号的用户头像
items[].subscription_status integer/null 当前粉丝对该偶像的订阅状态：1=生效中，2=已过期，3=已取消
items[].subscription_expires_at string/null 当前或最近一次订阅过期时间
items[].benefit_total_count integer 该偶像当前上架福利数量
items[].redeemable_count integer 当前粉丝对该偶像可兑换福利数量
items[].redeemed_count integer 当前粉丝对该偶像已兑换福利数量
items[].has_new_redeemable integer 是否存在新的可兑换福利：1=是，2=否
pagination.page integer 当前页码
pagination.page_size integer 每页数量
pagination.total integer 总数量
pagination.next_cursor string/null 游标分页预留字段，当前为空

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "items": [
      {
        "artist_id": 20001,
        "artist_name": "王心凌",
        "artist_avatar": "https://cdn.example.com/artist/avatar.png",
        "subscription_status": 1,
        "subscription_expires_at": "2026-07-22 10:00:00",
        "benefit_total_count": 3,
        "redeemable_count": 1,
        "redeemed_count": 1,
        "has_new_redeemable": 1
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 1,
      "next_cursor": null
    }
  }
}