Photos API - 首页

照片管理 API 端点

GET /api/photos
获取所有照片（支持分页）
查询参数: page, limit, search
返回: 照片列表 + 分页信息

GET /api/photos/random
随机获取一张照片
返回: 单个照片对象

GET /api/photos/:id
根据ID获取特定照片
路径参数: id (照片ID)
返回: 单个照片对象

POST /api/photos
创建新的照片记录
请求体: url*, title, description, tags
返回: 创建的照片对象

PUT /api/photos/:id
更新现有照片信息
路径参数: id (照片ID)
请求体: url, title, description, tags
返回: 更新后的照片对象

DELETE /api/photos/:id
删除指定照片
路径参数: id (照片ID)
返回: 删除成功消息

用户管理 API 端点

POST /api/users/register
用户注册
请求体: username*, password*, role
返回: 用户信息 + JWT token

POST /api/users/login
用户登录
请求体: username*, password*
返回: 用户信息 + JWT token

POST /api/users/verify
验证JWT token
请求头: Authorization: Bearer {token}
返回: 用户信息

GET /api/users/profile
获取当前用户信息
请求头: Authorization: Bearer {token}
返回: 当前用户信息

GET /api/users
获取所有用户（管理员）
请求头: Authorization: Bearer {token}
查询参数: page, limit
返回: 用户列表 + 分页信息

PUT /api/users/:id
更新用户信息
请求头: Authorization: Bearer {token}
路径参数: id (用户ID)
请求体: username, password, role, isActive
返回: 更新后的用户信息

DELETE /api/users/:id
删除用户（管理员）
请求头: Authorization: Bearer {token}
路径参数: id (用户ID)
返回: 删除成功消息

数据模型

📸 Photo 照片模型

url: String [必填]
照片的URL地址

title: String
照片标题

description: String
照片描述

tags: Array[String]
照片标签数组

createdAt: Date
创建时间（自动生成）

updatedAt: Date
更新时间（自动生成）

👤 User 用户模型

username: String [必填]
用户名（3-20个字符，唯一）

password: String [必填]
密码（至少6个字符，加密存储）

role: String
用户角色：'admin' | 'user'（默认：'user'）

isActive: Boolean
账户状态（默认：true）

lastLogin: Date
最后登录时间

createdAt: Date
注册时间（自动生成）

响应格式

✅ 成功响应格式

{
  "code": 2000,
  "data": {
    // 具体数据内容
  },
  "message": "操作成功"
}

📄 分页响应格式

{
  "code": 2000,
  "data": [
    // 数据数组
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 10,
    "totalItems": 100,
    "itemsPerPage": 10,
    "hasNextPage": true,
    "hasPrevPage": false
  },
  "message": "获取成功"
}

❌ 错误响应格式

{
  "code": 4001,
  "message": "参数验证失败",
  "data": null
}

🔐 认证说明

需要认证的接口请在请求头中包含JWT token：

Authorization: Bearer {your_jwt_token}

📋 响应码说明

• 2xxx: 成功响应
• 4xxx: 客户端错误（参数错误、认证失败等）
• 5xxx: 服务器错误

照片管理

完整的 CRUD 操作，支持照片的创建、读取、更新和删除

随机展示

智能随机算法，为您呈现精彩的照片内容

分页浏览

高效的分页系统，轻松浏览大量照片内容

RESTful API

标准化的 API 接口，易于集成和开发

写真馆 API