API 概览

MineShop 提供 RESTful 风格的 API 接口，分为后台管理接口和前端用户接口。

🎯 接口分类

分类	前缀	说明
后台接口	/admin	管理后台使用
前端接口	/api	用户端使用

🔐 认证方式

JWT Token

所有接口（除登录外）需要在请求头携带 Token：

Authorization: Bearer <token>

获取 Token

POST /admin/login
Content-Type: application/json

{
    "username": "admin",
    "password": "admin123"
}

响应：

{
    "code": 200,
    "message": "success",
    "data": {
        "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
        "expire_at": 1234567890
    }
}

📦 响应格式

成功响应

{
    "code": 200,
    "message": "success",
    "data": {
        // 业务数据
    }
}

分页响应

{
    "code": 200,
    "message": "success",
    "data": {
        "items": [...],
        "total": 100,
        "page": 1,
        "pageSize": 20
    }
}

错误响应

{
    "code": 400,
    "message": "参数错误",
    "data": null
}

📋 状态码

状态码	说明
200	成功
400	参数错误
401	未授权
403	禁止访问
404	资源不存在
500	服务器错误

📚 相关文档

• 后台接口
• 前端接口
• 认证授权