7. 粉丝端 API 7.15 我的福利兑换记录【基础探测通过，待数据联调】

Table of Contents

7.15 我的福利兑换记录【基础探测通过，待数据联调】

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

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

查询参数：

参数 类型 必填 说明
page integer 否 页码，默认 1
page_size integer 否 每页数量，默认 20
redemption_status integer 否 兑换状态筛选：1=待发放，2=已发放
benefit_id integer 否 福利 ID 筛选

响应字段：

字段 类型 说明
items array 当前页数据列表
items[].redemption_id integer 福利兑换记录 ID
items[].redemption_no string 福利兑换编号
items[].benefit_id integer 福利 ID
items[].benefit_title string 福利标题
items[].benefit_type integer/null 福利类型：1=实物，2=虚拟
items[].redemption_status integer 福利兑换状态：1=待发放，2=已发放，3=已取消，4=已退款
items[].address_snapshot object/null 地址快照对象，虚拟福利为空；新直传地址场景包含三字段，使用 address_id 或历史数据时可能包含省市区等扩展字段
items[].address_snapshot.receiver_name string 收货人姓名
items[].address_snapshot.receiver_phone string 收货人手机号
items[].address_snapshot.detail_address string 详细地址
items[].email_snapshot string 邮箱快照，未填写时为空字符串
items[].fulfillment_remark string/null 发放备注
items[].redeemed_at string/null 兑换时间
items[].fulfilled_at string/null 发放时间
pagination.page integer 当前页码
pagination.page_size integer 每页数量
pagination.total integer 总数量

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "items": [
      {
        "redemption_id": 60001,
        "redemption_no": "BR202606170001",
        "benefit_id": 30001,
        "benefit_title": "亲笔签名照",
        "benefit_type": 1,
        "redemption_status": 1,
        "address_snapshot": {
          "receiver_name": "张三",
          "receiver_phone": "13800000000",
          "detail_address": "上海市黄浦区详细地址"
        },
        "email_snapshot": "fan@example.com",
        "fulfillment_remark": null,
        "redeemed_at": "2026-06-23 14:30:00",
        "fulfilled_at": null
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 1,
      "next_cursor": null
    }
  }
}