pyx_gitkeshe/library_system/文档.md

书籍租赁系统  
前端对接后端接口文档（无 JWT · 纯 Session）

---

### 一、通用信息
| 项               | 值                                        |
| ---------------- | ----------------------------------------- |
| 基地址           | `http://localhost:8877`                   |
| 认证方式         | Cookie（Session）                         |
| 统一返回         | `{ code: 200/1, message: "", data: ... }` |
| 白名单（免登录） | `POST /user/login` `POST /user/register`  |

---

### 二、用户模块
#### 1. 注册
```
POST /user/register
Content-Type: application/x-www-form-urlencoded

username=xxx&password=xxx
```
成功 → `{ code:200, message:"操作成功" }`

#### 2. 登录
```
POST /user/login
Content-Type: application/x-www-form-urlencoded

username=xxx&password=xxx
```
成功 → `{ code:200, message:"登陆成功！" }`  
失败 → `{ code:1, message:"账号或密码错误！" }`

#### 3. 获取当前用户信息
```
GET /user/getinfo
```
返回
```json
{
  "username": "张三",
  "pic": "http://xxx/avatar.png"
}
```

#### 4. 充值
```
POST /user/recharge
Content-Type: application/x-www-form-urlencoded

money=50
```
返回
```json
{ code:200, message:"成功充值：50.0元" }
```

#### 5. 余额 + VIP
```
POST /user/findmoney
```
返回
```json
{ code:200, message:"余额为：100.0元 当前VIP等级为：2" }
```

#### 6. 借书记录
```
GET /user/findone
```
- 普通用户：单条对象  
- 管理员：数组

---

### 三、书籍模块
#### 1. 新增书籍（管理员）
```
POST /api/add
Content-Type: application/json

{
  "title":"三体",
  "content":"科幻小说",
  "url":"http://...jpg",
  "state":"草稿",
  "money":5.00,
  "number":10
}
```
成功 → 返回完整书籍对象

#### 2. 查询全部书籍
```
GET /api/select
```
返回数组

#### 3. 书名查单本
```
GET /api/selectone?title=三体
```
返回单条对象

#### 4. 删除书籍（管理员）
```
POST /user/delete
Content-Type: application/x-www-form-urlencoded

title=三体
```
返回
```json
{ code:200, message:"该书本已删除！" }
```

#### 5. 当前用户已借书籍
```
GET /user/borrow/books
```
返回书籍数组

---

### 四、租借模块
#### 1. 借书
```
POST /borrow/borrowbook
Content-Type: application/x-www-form-urlencoded

title=三体
```
- 余额不足 → `{ code:1, message:"余额不足！" }`  
- 成功 → `{ code:200, data:{...} }`

#### 2. 还书
```
POST /borrow/returnbook
Content-Type: application/x-www-form-urlencoded

title=三体
```
返回
```json
{ code:200, data:{..., return_time:"2025-07-25T16:35:00"} }
```

---

### 五、排行模块
#### 1. 本周热租榜
```
GET /api/rank/weekly
```
返回
```json
[
  { "title":"三体", "url":"...", "money":5, "number":12 },
  ...
]
```

#### 2. 本月热租榜
```
GET /api/rank/monthly
```
结构同上