This commit is contained in:
张成
2026-04-29 13:46:24 +08:00
parent dee3a336ce
commit b7208545e3
7 changed files with 277 additions and 68 deletions

View File

@@ -497,68 +497,6 @@ curl "$BASE/admin_api/sys_log/operates?pageOption=%7B%22page%22%3A1%2C%22pageSiz
}
```
---
### 4.6 控件类型 `sys_control_type`
源码:`controller/admin/sys_control_type.js`
| 路径 | 方法 | 认证 | 说明 |
|------|------|------|------|
| `/sys_control_type/all` | GET | admin | 全部未删除记录。 |
| `/sys_control_type/page` | POST | admin | Body 需含 **`seachOption`**`{ key, value }` 时对 `key` 字段 `LIKE`;分页 **`pageOption`** 经 `getPageSize()` 解析;排序 `id DESC`。 |
| `/sys_control_type/add` | POST | admin | 新增。 |
| `/sys_control_type/edit` | POST | admin | `id` + 更新字段。 |
| `/sys_control_type/del` | POST | admin | 软删除:`id`。 |
**`POST /sys_control_type/page` 请求 body完整示例**
```json
{
"seachOption": { "key": "name", "value": "输入" },
"pageOption": { "page": 1, "pageSize": 20 }
}
```
**`POST /sys_control_type/add` 请求 body完整示例**
```json
{
"name": "上传组件",
"code": "upload",
"desc": "文件上传控件"
}
```
**`POST /sys_control_type/edit` 请求 body完整示例**
```json
{
"id": 5,
"name": "上传组件(单文件)",
"desc": "限制单文件上传"
}
```
**`POST /sys_control_type/del` 请求 body完整示例**
```json
{
"id": 5
}
```
**响应示例(成功):**
```json
{
"/sys_control_type/all": { "code": 0, "message": "请求成功", "data": [{ "id": 5, "name": "上传组件" }] },
"/sys_control_type/page": { "code": 0, "message": "请求成功", "data": { "count": 1, "rows": [{ "id": 5, "name": "上传组件" }] } },
"/sys_control_type/add": { "code": 0, "message": "请求成功", "data": { "id": 5, "name": "上传组件" } },
"/sys_control_type/edit": { "code": 0, "message": "请求成功", "data": [1] },
"/sys_control_type/del": { "code": 0, "message": "请求成功", "data": [1] }
}
```
---
@@ -1340,7 +1278,6 @@ start().catch((error) => {
1. **白名单**为子串匹配,自定义公开接口时避免与 `/login` 等敏感片段无意冲突。
2. **系统管理接口**路径前缀为 **`/admin_api`**;业务前缀在 `apiPaths` 中单独配置。
3. **`sys_user/edit`** 源码对 `password` 直接取长度,调用时请始终传入 `password`(或按你们分支修复后再依赖可选密码)。
4. **`sys_control_type/page`** 需传 `seachOption` 对象,否则可能运行时报错。
5. **生产环境**授权、依赖版本与数据库同步策略以部署与发行说明为准。
6. 更完整的 OpenAPI 可通过 **`GET /api/swagger.json`** 与 Swagger UI 查看(与手写路由并行存在时,以生成内容为准)。