API 总览
YXShop 提供两套 API 接口:C 端 API(小程序调用)和管理端 API(后台管理调用)。
API 路由
| 类型 | 前缀 | 认证 |
|---|---|---|
| C 端 API | /api/v1 | JWT(C 端) |
| 管理端 API | /admin/api | JWT(管理端)+ 权限 |
请求格式
- Content-Type: application/json
- 认证头: Authorization: Bearer {token}
- 分页参数: page(页码,从 1 开始)、limit(每页条数)
响应格式
json
{
"code": 200,
"message": "success",
"data": {
"list": [],
"total": 0,
"page": 1,
"limit": 15
}
}
状态码
| 状态码 | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 请求参数错误 |
| 401 | 未认证 / Token 过期 |
| 403 | 无权限 |
| 404 | 资源不存在 |
| 500 | 服务器错误 |