@alanwang-merit/meritdata-platform-skill-package 1.0.0

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/31_2.4/347/224/250/346/210/267/347/273/264/346/212/244-/344/270/212/345/215/212.md

@@ -0,0 +1,490 @@
+---
+name: 2.4 用户维护（上半）
+source-file: 外部接口清单
+source-section: 2.4.1–2.4.7 用户维护
+keywords: [用户校验, 用户新增, 用户删除, 停用, 启用]
+use-cases: [用户CRUD, 用户启停]
+related: [32_2.4用户维护-下半.md]
+---
+
+# 2.4 用户维护（上半）
+
+> **原文章节**：`外部接口清单 → 2.4.1–2.4.7 用户维护`
+> **行号范围**：L5566-L6029
+
+## 🎯 一句话
+本章节覆盖用户登录校验、新增、删除、停用、启用及按 ID 查询等基础维护接口。
+
+## 📋 接口清单
+
+## 2.4 用户维护
+
+---
+
+### 2.4.1
+
+- **接口地址**：`/api/ou/user/changePass`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`修改密码`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| newPass | AuOP8HP8rmDIHYf I2U0LYJq0iyaZ/Pd+ Eo4z0lH/9uZAmFb WEM0qmsX35CAnk PfHxjJEdiOFHoq0e HIGhU8kh8nzqjMY ngAiJUgg80mQwOh l5gUvHN6efZTGuh0 I9XH64n18vogqgdp Nj/xmzNdSRNLtgb mTVITOfFgWVl7KA 0k= | String | 是 | 暂无描述 |
+| oldPass | hfSb2v8ABDj0q72O ZMv7o8AnkRWe/O JQKXPSe/3VyzqMh yiG6xO7N2marTl3v oDvAdGbEB74Pnbs AMYakiFlJUCAMQ MLD3yvA+Stj9sTNA JMEbvFnQcK53Zf0 OMtEzgr8L3a8If2v UxkLpGEOjVNXxVE XjEQCkbzcmqfV3HE Cx4= | String | 是 | 暂无描述 |
+| username | p826926QPA0lX88J TpUvrw2d/OORo4s GCSeC5O3VPAfWd bDnhMAm9FQpX8g yVYUZYfcWzqi/3kF cKVKefo5y6Jas/K5k bhUUkZbRHj5Mm mNxCeGziJLpXryp8 JfT0yDWAZD4CQxA 0xX2/dLWzq9rWjN G5pMjYtjbN5pVhV | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.4.2
+
+- **接口地址**：`/api/ou/user/checksession`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`校验用户是否登录`
+---
+
+### 校验用户是否登录
+
+- **接口备注**：`校验用户是否登录`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.4.3
+
+- **接口地址**：`/api/ou/user/create`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`用户新增接口`
+---
+
+### 用户新增接口
+
+- **接口备注**：`用户新增接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 |  |  | 是否必填 | 参数描述 |
+|---|---|---|---|---|---|---|
+|  |  |  | 参数类型 |  |  |  |
+| addTime | String | String |  |  | 是 | 暂无描述 |
+| errTimes | 21312131 | String |  |  | 是 | 暂无描述 |
+| grade | String | String |  |  | 是 | 暂无描述 |
+| ipAddress | String | String |  |  | 是 | 暂无描述 |
+| lastTime | String | String |  |  | 是 | 暂无描述 |
+| macAddress | String | String |  |  | 是 | 暂无描述 |
+| name | wwwdsa | String |  |  | 是 | 暂无描述 |
+| password | EbrFIu1wzUxjAOhV ciLJ0WLtszvnaAOA/ A5VTGYB+woc3jVo qCXlGQ2w0hJKQdY Di48gbfk2bHqfHsB 4LhLopR9IntL3ucN 8XsQGEjGBetC5uJO 2rXeULpZylcuYOkM +ZZx8djzdEw4Y0nx 2UuNVQwKFu7VRl PY0Fmt3vgSxxQs= | String |  |  | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661163491031 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/ou/user/create | String | api 路径 |
+| data | true | Boolean | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661163491031,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/user/create",
+"data":true,
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+页 134/276
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.4.4
+
+- **接口地址**：`/api/ou/user/delete`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`用户删除接口`
+---
+
+### 用户删除接口
+
+- **接口备注**：`用户删除接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| ids | 1573ca748af64dfd b43c0b46965399fc | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661163581072 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/ou/user/delete | String | api 路径 |
+| data |  | Object | 返回数据 |
+| data.result | true | String | 结果集 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661163581072,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/user/delete",
+"data":{
+"result": "true"
+},
+"extraInfo":{},
+"success":true
+页 135/276
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.4.5
+
+- **接口地址**：`/api/ou/user/disable`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`用户停用接口`
+---
+
+### 用户停用接口
+
+- **接口备注**：`用户停用接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| ids | 331cd89d654148cb a5e750cb399a821b | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661163631910 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/ou/user/disable | String | api 路径 |
+| data | true | Boolean | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661163631910,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/user/disable",
+"data":true,
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.4.6
+
+- **接口地址**：`/api/ou/user/enable`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`用户启用接口`
+---
+
+### 用户启用接口
+
+- **接口备注**：`用户启用接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| ids | 331cd89d654148cb a5e750cb399a821b | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661163646263 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661163646263,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/user/enable",
+"data":true,
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.4.7 Id
+
+- **接口地址**：`/api/ou/user/get`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`根据Id 获取用户信息`
+---
+
+### 根据获取用户信息
+
+- **接口备注**：`根据Id 获取用户信息`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| id | 331cd89d654148cb | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661163671332 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/ou/user/get | String | api 路径 |
+| data |  | String | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661163671332,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/user/get",
+"data":{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": 1646808970000,
+"updateTime": 1661163671332,
+"creatorId": null,
+"reviserId": null,
+"id": "331cd89d654148cba5e750cb399a821b",
+"username": "cheng",
+"password":
+"{bcrypt}$2a$10$i/AaG6YDDY7Ejyz91gRN.ebG.PqRYgxRDfpBBUIsKq3b62Kg4YB
+tC",
+"status": "1",
+"ipAddress": null,
+"passChanged": 1647824901000,
+"passLocked": null,
+"macAddress": null,
+"errTimes":0,
+"userId": "bddcc17290ad48eb8dacb7d3892cddd3",
+"grade": null,
+页 139/276
+"authorities": null,
+"authoritiesIds": null,
+"name": "陈",
+"code": "8888",
+"deptId": null,
+"deptCode": null,
+"orgId": null,
+"orgName": null,
+"rootOrgId": null,
+"deptName": null,
+"gradeName": null,
+"secret": null,
+"loginIp": null,
+"email": null,
+"threeMemberManage":false,
+"threeMemberManagEmpChange":false,
+"adminUser":false,
+"userType": null,
+"addTime": null,
+"lastTime": null,
+"enabled":true,
+"accountNonLocked":true,
+"credentialsNonExpired":true,
+"accountNonExpired":true
+},
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+
+## 💡 使用建议
+- 用户新增、删除和启停操作前校验 ids、用户名等必填参数。
+- 用户状态变更后建议重新查询用户信息确认生效。
+
+## 🔗 相关章节
+- 32_2.4用户维护-下半.md