卡密与订阅管理 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"
}
]