7. 粉丝端 API 7.3 订阅详情【基础探测通过，待数据联调】

Table of Contents

7.3 订阅详情【基础探测通过，待数据联调】

GET /tieup/api/v1/me/subscriptions/{subscription_no}

路径参数：

参数 类型 必填 说明
subscription_no string 是 订阅编号
响应字段：
字段 类型 说明
subscription_no string 订阅编号
fan_user_id integer 当前粉丝用户 ID
artist_id integer 艺人 ID
artist_user_id integer 艺人绑定 APP 用户 ID
artist_name string 艺人名称
artist_avatar string 艺人头像，严格读取独立维护的 tieup_artist.avatar；未配置时返回空字符串，不回退绑定账号的用户头像
order_no string 订阅对应平台订单号
recharge_no string/null 订阅对应业务单号
subscription_plan_code string 订阅档位编码
plan_name_snapshot string 订阅档位名称快照
sub_type string 订阅周期类型：month=月卡，year=年卡
subscription_action string 订阅动作：initial/renewal/legacy
pay_amount string 支付金额，单位元，固定两位小数
duration_days integer 本周期权益天数
started_at string 订阅开始时间
expires_at string 订阅过期时间
is_auto_renew integer 业务自动续费状态：1=是，2=否；该字段为客户端展示依据
status integer 订阅状态：1=生效中，2=已过期，3=已取消，4=即将过期
cancelled_at string/null 取消时间
original_transaction_id string/null Apple 自动订阅链原始交易 ID；非 Apple 或历史未绑定订阅为空
latest_transaction_id string/null 服务端已处理的最近 Apple 交易 ID
latest_apple_notification_type string/null 最近一条按 Apple signedDate 生效的通知类型，如 DID_RENEW、EXPIRED
latest_apple_subtype string/null 最近 Apple 通知 subtype；用户关闭自动续费后自然到期通常为 VOLUNTARY
auto_renew_status integer/null Apple 原始自动续费状态：0=关闭，1=开启，null=Apple 未提供或历史未知

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "subscription_no": "TS202606170001",
    "fan_user_id": 10001,
    "artist_id": 20001,
    "artist_user_id": 30001,
    "artist_name": "示例艺人",
    "artist_avatar": "https://cdn.example.com/artist.png",
    "order_no": "TO202606170001",
    "recharge_no": "RC202606170001",
    "subscription_plan_code": "month_vip",
    "plan_name_snapshot": "月度订阅",
    "sub_type": "month",
    "subscription_action": "initial",
    "pay_amount": "29.90",
    "duration_days": 30,
    "started_at": "2026-06-17 10:00:00",
    "expires_at": "2026-07-17 23:59:59",
    "is_auto_renew": 2,
    "status": 4,
    "cancelled_at": null,
    "original_transaction_id": "2000001208186444",
    "latest_transaction_id": "2000001208186555",
    "latest_apple_notification_type": "DID_RENEW",
    "latest_apple_subtype": "",
    "auto_renew_status": 0
  }
}