卡密与订阅管理 API

本章节涵盖了用于管理产品卡密(激活码)以及查看活跃订阅订单的管理员接口。

注意: 所有接口均需要管理员权限认证 (/api/admin/*)。


卡密管理 (Cards)

1. 获取卡密列表

获取系统中所有的卡密列表,包括它们的使用状态和关联的产品名称。

  • 请求地址: /api/admin/cards
  • 请求方法: GET
  • 权限要求: 管理员 (Admin)

成功响应 (200)

[
  {
    "id": 1,
    "productId": 3,
    "productName": "Steam Gift Card $50",
    "cardNumber": "STEAM-XXXX-YYYY-ZZZZ",
    "isUsed": false,
    "orderId": null,
    "createdAt": "2024-03-21T10:00:00.000Z"
  }
]

2. 批量导入卡密

为指定的 key 类型产品批量导入多个卡密。

  • 请求地址: /api/admin/cards
  • 请求方法: POST
  • 权限要求: 管理员 (Admin)

请求体 (Body)

{
  "productId": 3,
  "cardNumbers": ["KEY-1234-ABCD", "KEY-5678-EFGH"]
}

成功响应 (200)

{
  "code": 0,
  "message": "Successfully added 2 cards"
}

错误响应 (400) - 参数缺失

{
  "statusCode": 400,
  "message": "Missing required fields"
}

3. 删除卡密

从系统中删除一个未被使用的卡密。

  • 请求地址: /api/admin/cards/:id
  • 请求方法: DELETE
  • 权限要求: 管理员 (Admin)

成功响应 (200)

{
  "code": 0,
  "message": "Card deleted successfully"
}

错误响应 (400) - 卡密已被使用

{
  "code": 1,
  "message": "Cannot delete a card that has already been used"
}

订阅管理 (Subscriptions)

1. 获取订阅列表

获取系统中所有被归类为订阅类型的订单列表(订单状态为 active 或 expired)。

  • 请求地址: /api/admin/subscriptions
  • 请求方法: GET
  • 权限要求: 管理员 (Admin)

成功响应 (200)

[
  {
    "id": "ORD123456789",
    "amount": 29.99,
    "contactEmail": "user@example.com",
    "status": "active",
    "createdAt": "2024-03-01T10:00:00.000Z",
    "paidAt": "2024-03-01T10:05:00.000Z",
    "metaData": {
      "subscription_cycle": "1_month",
      "expire_at": 1711965600000
    },
    "productId": 5,
    "productName": "Pro SaaS Plan",
    "userId": 42,
    "userNickname": "John Doe"
  }
]