Categories 分类管理 模块 API 文档
基础信息
- Base URL:
/api/admin - 认证方式: JWT Bearer Token
数据库表
categories— 分类表bills— 账单表
接口列表
1. 获取分类列表
GET /api/admin/categories
说明: 获取所有账单下的分类列表
响应:
[{
"id": "string",
"bill_id": "string",
"bill_name": "string",
"name": "string",
"icon": "string",
"color": "string",
"type": "income|expense",
"is_default": 0|1,
"is_archived": 0|1
}]
2. 创建分类
POST /api/admin/categories
请求体:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| bill_id | string | 必填 | 所属账单ID |
| name | string | 必填 | 分类名称 |
| type | string | 必填 | income | expense |
| icon | string | 选填 | 图标 emoji（默认 📁） |
| color | string | 选填 | 颜色（默认 #6366f1） |
| parent_id | string | 选填 | 父分类ID |
响应: {"success": true, "id": "string"}
3. 更新分类
PUT /api/admin/categories/:id
请求体:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 选填 | 分类名称 |
| icon | string | 选填 | 图标 |
| color | string | 选填 | 颜色 |
响应: {"success": true}
4. 删除分类
DELETE /api/admin/categories/:id
响应: {"success": true}
POST/admin/categories
**说明**：新建分类。
**请求参数**：
- `bill_id`（必填）：账单 ID
- `name`（必填）：分类名称
- `type`（必填）：类型（income/expense）
- `icon`：图标（默认 📁）
- `color`：颜色（默认 #6366f1）
- `parent_id`：父分类 ID（可选）
**响应**：
{ success: true, id: "分类ID" }
PUT/admin/categories/:id
**说明**：更新分类信息。
**请求参数**：
- `name`：新名称
- `icon`：新图标
- `color`：新颜色
**响应**：
{ success: true }
DELETE/admin/categories/:id
**说明**：删除指定分类。
**响应**：
{ success: true }