@alanwang-merit/meritdata-platform-skill-package 1.0.9 → 1.0.10

package/skills/meritdata-platform-integration/references/external-api/full/26_2.1/347/273/204/347/273/207/347/273/264/346/212/244-/344/270/213/345/215/212.md

@@ -0,0 +1,567 @@
+---
+name: 组织维护-下半（2.1.7-2.1.11）
+source-file: 外部接口清单
+source-section: 2 组织机构 → 2.1 组织维护 → 2.1.7–2.1.11
+keywords: [组织列表, 组织机构树, tempo组织, orgDeptTree, tree, orgId]
+use-cases: [组织查询, 组织树, tempo集成, 按ID批量查询]
+related: [25]
+---
+
+# 组织维护-下半（2.1.7-2.1.11）
+
+> **原文章节**：外部接口清单 → 2 组织机构 → 2.1 组织维护 → 2.1.7–2.1.11
+> **行号范围**：L2546–L3086
+
+## 🎯 一句话
+组织维护的高级查询接口：组织列表（分页）、按 ID 批量查询、组织机构树（orgDeptTree）、按 root 查询机构树、tempo 专用组织树。
+
+## 📋 接口清单
+
+---
+
+### 2.1.7
+
+- **接口地址**：`/api/ou/org/list`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`组织列表接口`
+---
+
+### 组织列表接口
+
+- **接口备注**：`组织列表接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| page | 1 | String | 是 | 分页页码，数字类型 |
+| rows | 10 | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661225715963,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/org/list",
+"data":{
+"rows": [
+{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": 1658287341000,
+"updateTime": 1658287341000,
+"creatorId": null,
+"reviserId": null,
+"id": "3f2883b282195033018219a0be6b004e",
+"name": "11",
+"simpleName": "11",
+"isAble": "1",
+"dLevel": "0",
+"parentId":
+"3f2883b2821950330182199cb96e0047",
+"deptCode": "11",
+"remark": null,
+"sort":0,
+"dLevelCode": "000001000001",
+"province": null,
+"children": null,
+"city": null,
+"contactNumber": null,
+"type": null,
+页64/276
+"disableFlag": null,
+"c": null,
+"d": null,
+"e": null,
+"f": null,
+"g": null,
+"h": null,
+"i": null,
+"j": null,
+"k": null,
+"l": null,
+"m": null,
+"n": null,
+"o": null,
+"p": null,
+"q": null,
+"r": null,
+"s": null,
+"t": null,
+"u": null,
+"v": null,
+"w": null,
+"x": null,
+"y": null,
+"z": null
+},
+],
+"deptcodes": null,
+"total": 5,
+"pageSize":0,
+"pageNumber":0,
+"totalPages":0,
+"records":0
+},
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.1.8 ID
+
+- **接口地址**：`/api/ou/org/list-by-ids`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`根据ID 查询组织机构信息`
+---
+
+### 根据查询组织机构信息
+
+- **接口备注**：`根据ID 查询组织机构信息`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661232632393 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/ou/org/list-by-ids | String | api 路径 |
+| data |  | Array | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661232632393,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/org/list-by-ids",
+"data": [
+页66/276
+{
+"tenantId": null,
+"secretCode": null,
+"secretName": null,
+"createTime": null,
+"updateTime": null,
+"creatorId": null,
+"reviserId": null,
+"id": "1",
+"name": "组织机构",
+"simpleName": "组织机构",
+"isAble": "1",
+"dLevel": "0",
+"parentId": null,
+"deptCode": "001",
+"remark": null,
+"sort":0,
+"dLevelCode": null,
+"province": null,
+"children": null,
+"city": null,
+"contactNumber": null,
+"type": null,
+"disableFlag": null,
+"c": null,
+"d": null,
+"e": null,
+"f": null,
+"g": null,
+"h": null,
+"i": null,
+"j": null,
+"k": null,
+"l": null,
+"m": null,
+"n": null,
+"o": null,
+"p": null,
+"q": null,
+"r": null,
+"s": null,
+"t": null,
+"u": null,
+"v": null,
+"w": null,
+"x": null,
+"y": null,
+页67/276
+"z": null
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.1.9
+
+- **接口地址**：`/api/ou/org/orgDeptTree`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`组织机构树接口`
+---
+
+### 组织机构树接口
+
+- **接口备注**：`组织机构树接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| orgId | 1 | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661232761102 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/ou/org/orgDeptTree | String | api 路径 |
+| data |  | Array | 返回数据 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661232761102,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/org/orgDeptTree",
+"data": [
+{
+"id": "3f2883b2821950330182199cb96e0047",
+"parentId": "1",
+"name": "美林数据",
+"simpleName": "美林数据",
+"type": "org",
+"checked":false,
+"state": null,
+"code": "merit",
+"dleveCode": "000001",
+"icon": "iconfonticon-jigou",
+"disabled":false,
+"checkBox":false,
+"dLevel": null,
+"children": [
+{
+"id":
+"3f2883b282195033018219a0be6b004e",
+"parentId":
+"3f2883b2821950330182199cb96e0047",
+"name": "11",
+"simpleName": "11",
+"type": "org",
+"checked":false,
+"state": null,
+"code": "11",
+"dleveCode": "000001000001",
+"icon": "iconfonticon-jigou",
+"disabled":false,
+"checkBox":false,
+"dLevel": null,
+"children": null,
+"haveChildren":false,
+"stringList": null,
+页69/276
+"secretCode": null,
+"secretName": null
+},
+{
+"id":
+"3f2883b2823d5f6c01823d6c7554000a",
+"parentId":
+"3f2883b2821950330182199cb96e0047",
+"name": "dsd",
+"simpleName": "dsd",
+"type": "dept",
+"checked":false,
+"state": null,
+"code": "dsd",
+"dleveCode": "000001000005",
+"icon": "iconfonticon-bumenkaoqin",
+"disabled":false,
+"checkBox":false,
+"dLevel": null,
+"children": null,
+"haveChildren":false,
+"stringList": null,
+"secretCode": null,
+"secretName": null
+},
+],
+"haveChildren":false,
+"stringList": null,
+"secretCode": null,
+"secretName": null
+}
+```
+
+
+**返回失败示例**：
+
+```json
+页70/276
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.1.10 idroot
+
+- **接口地址**：`/api/ou/org/tree`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`根据组织id 和节点信息root 获取组织机构树`
+---
+
+### 根据组织和节点信息获取组织机构树
+
+- **接口备注**：`根据组织id 和节点信息root 获取组织机构树`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| showEnable | 1 | String | 否 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661235228598 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/ou/org/tree | String | api 路径 |
+| data |  | Array | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661235228598,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/org/tree",
+"data": [
+{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": 1658287077000,
+"updateTime": 1658287077000,
+页71/276
+"creatorId": null,
+"reviserId": null,
+"id": "3f2883b2821950330182199cb96e0047",
+"name": "美林数据",
+"simpleName": "美林数据",
+"isAble": "1",
+"dLevel": "0",
+"parentId": "1",
+"deptCode": "merit",
+"remark": null,
+"sort":0,
+"dLevelCode": "000001",
+"province": null,
+"children": null,
+"city": null,
+"contactNumber": null,
+"type": null,
+"disableFlag": null,
+"c": null,
+"d": null,
+"e": null,
+"f": null,
+"g": null,
+"h": null,
+"i": null,
+"j": null,
+"k": null,
+"l": null,
+"m": null,
+"n": null,
+"o": null,
+"p": null,
+"q": null,
+"r": null,
+"s": null,
+"t": null,
+"u": null,
+"v": null,
+"w": null,
+"x": null,
+"y": null,
+"z": null
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.1.11 tempo
+
+- **接口地址**：`/api/ou/org/tree-tempo`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`tempo 使用`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661233804280 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/ou/org/tree-tempo | String | api 路径 |
+| data |  | Array | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+页73/276
+"timestamp": 1661233804280,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/org/tree-tempo",
+"data": [
+{
+"code": "merit",
+"isAble": "1",
+"simpleName": "美林数据",
+"name": "美林数据",
+"pid": "1",
+"id": "3f2883b2821950330182199cb96e0047",
+"sort":0,
+"type": "org",
+"dLevelCode": "000001"
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+## 💡 使用建议
+- 2.1.7 `list` 是 **分页查询**（`page/rows`），2.1.8 `list-by-ids` 是 **按 ID 批量查询**（无请求体，参数在 URL 或 Header）
+- 2.1.9 `orgDeptTree` 返回结构化树（带 `children` 字段），适合前端直接渲染 el-tree
+- 2.1.11 `tree-tempo` 是 tempo BI 专用，返回字段 `pid` 而非 `parentId`
+
+## 🔗 相关章节
+- [25_2.1组织维护-上半](./25_2.1组织维护-上半.md)