7. 粉丝端 API 7.3.2 自动续订协议详情

Table of Contents

7.3.2 自动续订协议详情

GET /tieup/api/v1/me/subscription-agreements/{agreement_no}
Authorization: Bearer <access_token>

路径参数：

参数 类型 必填 说明
agreement_no string 是 Tieup 自动续订协议号

响应字段与 7.3.1 items[] 完全一致，返回单个协议对象。第三方 Product ID、Subscription Group、模板 ID、支付账号和内部快照均不对 APP 返回。

完整响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "agreement_no": "SA2026081012000012345678",
    "artist_id": 20001,
    "artist_name": "示例艺人",
    "artist_avatar": "https://cdn.example.com/artist.png",
    "subscription_plan_code": "month_vip",
    "sub_type": "month",
    "payment_method": "apple_iap",
    "first_order_no": "TO2026081012000012345678",
    "status": 3,
    "signed_at": "2026-08-10 12:01:00",
    "last_charge_at": "2026-08-10 12:01:00",
    "next_charge_at": "2026-09-10 12:01:00",
    "terminated_at": null,
    "failure_count": 0,
    "next_retry_at": null,
    "created_at": "2026-08-10 12:00:00"
  }
}