diff --git a/书籍租赁系统.pdf b/书籍租赁系统.pdf deleted file mode 100644 index ce974f1..0000000 Binary files a/书籍租赁系统.pdf and /dev/null differ diff --git a/接口文档.md b/接口文档.md new file mode 100644 index 0000000..745b68f --- /dev/null +++ b/接口文档.md @@ -0,0 +1,170 @@ +书籍租赁系统 +前端对接后端接口文档(无 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 +``` +结构同上 +