📡 API 接口文档

Base URL: /api/v1 · 响应格式: JSON

← 返回首页 管理后台

🔐 认证方式

标记 需认证 的接口需要在请求头中携带 Bearer Token：

Authorization: Bearer <your_token>

获取 Token：调用 POST /api/v1/auth/login 接口，Token 有效期 30 分钟（自最后活动起）。

认证

POST /api/v1/auth/login 公开 用户登录，获取 Token
POST /api/v1/auth/logout 需认证 用户登出，销毁会话

用户管理

GET /api/v1/users 需认证 用户列表（搜索、分页）
POST /api/v1/users 需认证 创建用户
PUT /api/v1/users/{id} 需认证 编辑用户
PATCH /api/v1/users/{id}/status 需认证 启用/禁用用户

角色权限

GET /api/v1/roles 需认证 角色列表
POST /api/v1/roles 需认证 创建角色
PUT /api/v1/roles/{id} 需认证 编辑角色
DELETE /api/v1/roles/{id} 需认证 删除角色
POST /api/v1/users/{id}/roles 需认证 分配用户角色

激活码

POST /api/v1/activation-codes/redeem 公开 兑换激活码
GET /api/v1/activation-codes 需认证 激活码列表（筛选、分页）
POST /api/v1/activation-codes/generate 需认证 批量生成激活码
GET /api/v1/activation-codes/export 需认证 导出 CSV

文章

GET /api/v1/articles 公开 已发布文章列表
GET /api/v1/admin/articles 需认证 文章管理列表（筛选、分页）
POST /api/v1/admin/articles 需认证 创建文章
PUT /api/v1/admin/articles/{id} 需认证 编辑文章
DELETE /api/v1/admin/articles/{id} 需认证 删除文章（软删除）
POST /api/v1/admin/articles/{id}/publish 需认证 发布文章

分类

GET /api/v1/admin/categories 需认证 分类列表
POST /api/v1/admin/categories 需认证 创建分类
PUT /api/v1/admin/categories/{id} 需认证 编辑分类
DELETE /api/v1/admin/categories/{id} 需认证 删除分类

站点设置

GET /api/v1/settings 公开 获取公开配置项
GET /api/v1/admin/settings 需认证 获取所有配置项
PUT /api/v1/admin/settings/{key} 需认证 更新配置项

广告

GET /api/v1/ads/{identifier} 公开 获取广告位有效广告
GET /api/v1/admin/ad-slots 需认证 广告位列表
POST /api/v1/admin/ad-slots 需认证 创建广告位
PUT /api/v1/admin/ad-slots/{id} 需认证 编辑广告位
DELETE /api/v1/admin/ad-slots/{id} 需认证 删除广告位
PATCH /api/v1/admin/ad-slots/{id}/status 需认证 启用/禁用广告位
GET /api/v1/admin/ad-slots/{slotId}/ads 需认证 广告位下的广告列表
POST /api/v1/admin/ad-slots/{slotId}/ads 需认证 创建广告
PUT /api/v1/admin/ads/{id} 需认证 编辑广告
DELETE /api/v1/admin/ads/{id} 需认证 删除广告