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

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/34_2.6/345/205/266/344/273/226/346/216/245/345/217/243-/344/270/212/345/215/212.md

@@ -0,0 +1,653 @@
+---
+name: 2.6 其他接口（上半）
+source-file: 外部接口清单
+source-section: 2.6.1–2.6.6 其他接口
+keywords: [用户人员对象, 登录名称, 角色集合, 组织用户树]
+use-cases: [用户对象查询, 树形组织]
+related: [35_2.6其他接口-下半.md]
+---
+
+# 2.6 其他接口（上半）
+
+> **原文章节**：`外部接口清单 → 2.6.1–2.6.6 其他接口`
+> **行号范围**：L6747-L7373
+
+## 🎯 一句话
+本章节提供按用户获取人员对象、按登录名获取 cateCode 和角色集合，以及组织用户树查询接口。
+
+## 📋 接口清单
+
+## 2.6 其他接口
+
+---
+
+### 2.6.1 ID
+
+- **接口地址**：`/api/dam/emp-info-by-user-`
+- **请求类型**：`text/plain`
+- **请求方式**：`get`
+- **接口备注**：`根据用户ID 获取人员对象`
+---
+
+### 根据用户获取人员对象
+
+- **接口备注**：`根据用户ID 获取人员对象`
+- **调试工具**：`ApiPost`
+
+**URI 参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| userId | 624a42c2c7444faca abac78686c2f4e4 | String | 否 | 用户 ID |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661242186837 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/dam/emp-info-by-user-id | String | api 路径 |
+| data |  | String | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661242186837,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/dam/emp-info-by-user-id",
+"data":{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": null,
+"updateTime": 1658884726000,
+"creatorId": null,
+"reviserId": null,
+"id": "3d6887c59b5642899425ea21202287b8",
+"name": "sadasd",
+"code": "sds",
+"sex": null,
+"birthday": null,
+"folk": null,
+"education": null,
+"handset": null,
+"familyPhone": null,
+页 156/276
+"email": null,
+"sortNo":8,
+"systemUser": 1,
+"deptId": "3f2883b2823d5f6c01823d6c7554000a",
+"deptCode": null,
+"deptName": null,
+"userId": null,
+"userState": null,
+"weixinNo": null,
+"province": null,
+"city": null,
+"county": null,
+"grade": null,
+"workgroupName": null,
+"workgroupId": null,
+"postName": null,
+"postId": null,
+"postFlag": null,
+"roleId": null,
+"ipAddress": null,
+"macAddress": null,
+"gradeName": null,
+"manageDeptName": null,
+"manageDeptId": null,
+"empCategorys":{},
+"cateCodes": null,
+"userName": null,
+"detptype": null,
+"roleName": null,
+"did": null,
+"isSubDsAdmin": null,
+"isCGSysadmin": null,
+"authStatus": null,
+"parentsOrgs":{},
+"resultName": null,
+"cycleDeptName": null,
+"userType": "1",
+"d": null,
+"addTime": null,
+"lastTime": null,
+"e": null,
+"f": null,
+"g": null,
+"h": null,
+"i": null,
+"j": null,
+"k": null,
+页 157/276
+"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
+},
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.6.2 cate Code 根据登录名称获取当前用户
+
+- **接口地址**：`/api/dam/get-cate-code-by-user-name`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`根据登录名称获取当前用户cateCode 接口`
+---
+
+### 根据登录名称获取当前用户接口
+
+- **接口备注**：`根据登录名称获取当前用户cateCode 接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| userName | zhangyan2 | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661242619040 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/dam/get-cate-code-by- user-name | 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": 1661242619040,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/dam/get-cate-code-by-user-name",
+"data": "",
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.6.3 ID 根据登录名称获取角色集合
+
+- **接口地址**：`/api/dam/get-role-ids-by-user-name`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`根据登录名称获取角色ID 集合接口`
+---
+
+### 根据登录名称获取角色集合接口
+
+- **接口备注**：`根据登录名称获取角色ID 集合接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| userName | zhangyan2 | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661242776603 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/dam/get-role-ids-by-user- name | String | api 路径 |
+| data | XTPTRY | Array | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661242776603,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/dam/get-role-ids-by-user-name",
+"data": [
+"XTPTRY",
+"XTGLY",
+"DDBPGLY"
+],
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.6.4
+
+- **接口地址**：`/api/dam/org-user-tree`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`组织用户树接口`
+---
+
+### 组织用户树接口
+
+- **接口备注**：`组织用户树接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661242799861 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/dam/org-user-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": 1661242799861,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/dam/org-user-tree",
+"data": [
+{
+页 161/276
+"id": "3f2883b2821950330182199cb96e0047",
+"parentId": "1",
+"name": "美林数据",
+"simpleName": null,
+"type": "",
+"checked":false,
+"state": null,
+"code": null,
+"dleveCode": null,
+"icon": "iconfonticon-jigou",
+"disabled":false,
+"checkBox":false,
+"dLevel": null,
+"children": [
+{
+"id":
+"3f2883b282195033018219a0be6b004e",
+"parentId":
+"3f2883b2821950330182199cb96e0047",
+"name": "11",
+"simpleName": null,
+"type": "",
+"checked":false,
+"state": null,
+"code": null,
+"dleveCode": null,
+"icon": "iconfonticon-jigou",
+"disabled":false,
+"checkBox":false,
+"dLevel": null,
+"children": [
+{
+"id":
+"602b31e6555d43e6aacc109a2ec464d8",
+"parentId":
+"3f2883b282195033018219a0be6b004e",
+"name": "张彦 2",
+"simpleName": null,
+"type": "user",
+"checked":false,
+"state": null,
+"code": null,
+"dleveCode": null,
+"icon": "iconfonticon-
+jiaoseyonghu",
+"disabled":false,
+"checkBox":false,
+页 162/276
+"dLevel": null,
+"children": null,
+"haveChildren":false,
+"stringList": null,
+"secretCode": null,
+"secretName": null
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.6.5
+
+- **接口地址**：`/api/dam/orgByName?name=44`
+- **请求类型**：`text/plain`
+- **请求方式**：`get`
+- **接口备注**：`根据组织名称查询组织信息`
+---
+
+### 根据组织名称查询组织信息
+
+- **接口备注**：`根据组织名称查询组织信息`
+- **调试工具**：`ApiPost`
+
+**URI 参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| name | 44 | String | 否 | 组织名称 |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661243072531 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/dam/orgByName | String | api 路径 |
+| data |  | Array | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661243072531,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/dam/orgByName",
+"data": [
+{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": 1658288451000,
+"updateTime": 1658288451000,
+"creatorId": null,
+"reviserId": null,
+"id": "3f2883b282195033018219b1af360053",
+"name": "44",
+"simpleName": "11",
+"isAble": "1",
+"dLevel": "0",
+"parentId": "3f2883b2821950330182199cb96e0047",
+"deptCode": "66",
+"remark": null,
+"sort": 2,
+"dLevelCode": "000001000003",
+"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,
+页 165/276
+"r": null,
+"s": null,
+"t": null,
+"u": null,
+"v": null,
+"w": null,
+"x": null,
+"y": null,
+"z": null
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.6.6 org Ids
+
+- **接口地址**：`/api/dam/orginfo-list`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`根据部门orgIds 集合获取组织机构信息`
+---
+
+### 根据部门集合获取组织机构信息
+
+- **接口备注**：`根据部门orgIds 集合获取组织机构信息`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661243119488,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/dam/orginfo-list",
+"data": [
+{
+"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,
+页 167/276
+"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":{}}
+```
+
+---
+
+
+## 💡 使用建议
+- 树形接口返回层级数据，前端展示前应处理 children 为空或缺失的情况。
+- 组织和用户查询接口的名称、用户 ID 参数应按接口类型正确传递。
+
+## 🔗 相关章节
+- 35_2.6其他接口-下半.md