版本 v1.0.0 • 欢迎使用会员消费管理系统API
提供会员消费管理系统的所有接口服务
以下是系统中可用的API接口,按功能分类
用户登录、注册、权限验证等接口
会员信息、消费记录、积分管理等接口
消费记录、商品管理、订单处理等接口
数据统计、报表生成、图表数据等接口
系统配置、权限管理、日志查询等接口
以下是一些常用接口的调用示例和响应格式
/api/auth/login
{
"username": "testuser",
"password": "123456"
}
{
"code": 200,
"msg": "\u767b\u5f55\u6210\u529f",
"data": {
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
"user_id": 1,
"username": "testuser",
"expires_in": 7200
}
}
{
"code": 401,
"msg": "\u7528\u6237\u540d\u6216\u5bc6\u7801\u9519\u8bef",
"data": null
}
/api/member/list?page=1&limit=10&status=1
无请求体(GET请求)
{
"code": 200,
"msg": "success",
"data": {
"list": [
{
"id": 1,
"name": "\u5f20\u4e09",
"phone": "13800138000",
"balance": 100.5
},
{
"id": 2,
"name": "\u674e\u56db",
"phone": "13800138001",
"balance": 200
}
],
"total": 100,
"page": 1,
"limit": 10,
"pages": 10
}
}
API使用的HTTP状态码及其含义
| 状态码 | 说明 | 典型场景 |
|---|---|---|
| 200 | 请求成功 | 请求处理成功 |
| 201 | 创建成功 | 资源创建成功 |
| 204 | 无内容 | 其他情况 |
| 400 | 请求参数错误 | 请求参数格式错误 |
| 401 | 未授权,需要登录 | 未提供有效Token |
| 403 | 禁止访问,权限不足 | 用户权限不足 |
| 404 | 资源不存在 | 请求的资源不存在 |
| 422 | 请求参数验证失败 | 其他情况 |
| 429 | 请求过于频繁 | 其他情况 |
| 500 | 服务器内部错误 | 服务器内部错误 |
| 503 | 服务暂时不可用 | 其他情况 |
所有接口都遵循以下响应格式