卡密储存系统 - API 文档

POST /api/register

用户注册（使用卡密）

使用有效卡密注册新用户，注册后自动获得卡密面额积分并返回 API Key。

请求体 (JSON)

{
    "card_key": "VIP-ABCD1234EFGH5678",
    "username": "testuser",
    "password": "123456"
}

成功响应

{
    "code": 200,
    "message": "注册成功",
    "data": {
        "username": "testuser",
        "api_key": "abc123def456...",
        "balance": 100
    }
}

POST /api/checkin

每日签到

每日签到获取积分奖励，连续签到奖励递增。需要在 Header 中提供 API Key。

请求头

X-API-Key: your_api_key_here

成功响应

{
    "code": 200,
    "message": "签到成功，获得 10 积分",
    "data": {
        "reward": 10,
        "balance": 110,
        "consecutive_days": 2,
        "total_checkins": 2
    }
}

GET /api/info

查询用户信息

查询当前用户余额、签到状态等信息。Header 需携带 X-API-Key。

GET /api/checkin/history

签到历史记录

查询最近 30 条签到记录。Header 需携带 X-API-Key。

GET /api/card/query

查询已使用卡密

查询当前用户关联的卡密使用记录。Header 需携带 X-API-Key。

GET /api/shop

卡密商城 - 获取可兑换列表

获取所有可兑换的卡密列表（status=unused）。Header 需携带 X-API-Key。可选参数 category 筛选分类。

请求示例

GET /api/shop?category=VIP
X-API-Key: your_api_key

成功响应

{
    "code": 200,
    "message": "获取成功",
    "data": {
        "balance": 150,
        "cards": [
            { "id": 1, "category": "VIP", "amount": 100, "remark": "月卡" }
        ]
    }
}

POST /api/redeem

积分兑换卡密

使用积分兑换卡密，兑换成功后返回卡密内容。Header 需携带 X-API-Key。

请求体 (JSON)

{ "card_id": 1 }

成功响应

{
    "code": 200,
    "message": "兑换成功",
    "data": {
        "card_key": "ABC123DEF456",
        "category": "VIP",
        "amount_cost": 100,
        "balance": 50
    }
}