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

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/22_1.16/347/273/204/347/273/207/344/272/272/345/221/230/345/220/214/346/255/245.md

@@ -0,0 +1,326 @@
+---
+name: 组织人员同步（1.16）
+source-file: 外部接口清单
+source-section: 1 基础配置 → 1.16 组织人员同步（1.16.1–1.16.5）
+keywords: [组织同步, 人员同步, 资源同步, 角色同步, 资源权限同步, WebService, RESTful, app-key, app-token]
+use-cases: [HR系统数据同步, 异构系统集成, 组织架构同步, 角色权限同步]
+related: [10, 34]
+---
+
+# 组织人员同步（1.16）
+
+> **原文章节**：外部接口清单 → 1 基础配置 → 1.16 组织人员同步（1.16.1–1.16.5）
+> **行号范围**：L1216–L1511
+
+## 🎯 一句话
+平台对外提供的 5 个组织/人员/资源/角色同步接口（`/webapi/ou/sync/*`），通过 `app-key` + `app-token` 鉴权，用于第三方系统（如 HR）向平台同步基础数据。
+
+## 📋 接口清单
+
+---
+
+## 1.16 组织人员同步参考开发攻略组织人员同步中具体说明
+
+---
+
+### 1.16.1 组织同步
+
+- **接口地址**：`/webapi/ou/sync/org`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`暂无描述`
+- **调试工具**：`ApiPost`
+
+**请求头参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| app-token | FI0FTnCXdgWEUkb 0iD3Zk3rOBs+hNPI ykuCcuroyEUc1KwJ nCSGRnntlYBeia1rO I8PjNH1ule/r4UQFx WXlCI+r6Eyvf4hIRX ASMUxsfK8M/S91I Uj9PiL0MPKvAZbqX djUiM5u2HYfEwYy mjsC5rGekp+lcet6J QErVZP4fSw= | String | 是 | 暂无描述 |
+| app-key | 05397e1e46394e38 8d531dabcd7a6783 | Text | 是 | 暂无描述 |
+| Content-Type | application/x-www- form-urlencoded | Text | 是 | 暂无描述 |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661223230204 | Number | 时间戳 |
+| status | 1 | Number | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | Object | 堆栈消息 |
+| path | /webapi/ou/sync/org | String | api 路径 |
+| data | 1 | String | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | String | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661223230204,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/webapi/ou/sync/org",
+"data": "1",
+"extraInfo":{},
+页26/276
+"success":true
+}
+```
+
+---
+
+### 1.16.2 人员同步
+
+- **接口地址**：`/webapi/ou/sync/user`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`暂无描述`
+- **调试工具**：`ApiPost`
+
+**请求头参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| Content-Type | application/x-www- form-urlencoded | String | 是 | 暂无描述 |
+| app-key | 05397e1e46394e38 8d531dabcd7a6783 | String | 是 | 暂无描述 |
+| app-token | FI0FTnCXdgWEUkb 0iD3Zk3rOBs+hNPI ykuCcuroyEUc1KwJ nCSGRnntlYBeia1rO I8PjNH1ule/r4UQFx WXlCI+r6Eyvf4hIRX ASMUxsfK8M/S91I Uj9PiL0MPKvAZbqX djUiM5u2HYfEwYy mjsC5rGekp+lcet6J QErVZP4fSw= | String | 是 | 暂无描述 |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| userInfo | <LIST><USER><RY_ STAFFNAME>同步 人员 1</RY_STAFFNAME ><RY_STAFFCODE> sync1</RY_STAFFC ODE><ORG_SIMPLE NAME>同步 </ORG_SIMPLENA ME><RY_PART_TIM E_DEPARTMENTCO | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661223364262 | Number | 时间戳 |
+| status | 1 | Number | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | Object | 堆栈消息 |
+| path | /webapi/ou/sync/user | String | api 路径 |
+| data | 1 | String | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | String | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661223364262,
+"status": 1,
+"message": "成功",
+页28/276
+"stackmessage": null,
+"path": "/webapi/ou/sync/user",
+"data": "1",
+"extraInfo":{},
+"success":true
+}
+```
+
+---
+
+### 1.16.3 资源同步
+
+- **接口地址**：`/webapi/ou/sync/resource`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`暂无描述`
+- **调试工具**：`ApiPost`
+
+**请求头参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| Content-Type | application/x-www- form-urlencoded | String | 是 | 暂无描述 |
+| app-key | 05397e1e46394e38 8d531dabcd7a6783 | String | 是 | 暂无描述 |
+| app-token | FI0FTnCXdgWEUkb 0iD3Zk3rOBs+hNPI ykuCcuroyEUc1KwJ nCSGRnntlYBeia1rO I8PjNH1ule/r4UQFx WXlCI+r6Eyvf4hIRX ASMUxsfK8M/S91I Uj9PiL0MPKvAZbqX djUiM5u2HYfEwYy mjsC5rGekp+lcet6J QErVZP4fSw= | String | 是 | 暂无描述 |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| resourceInfo | <ROOT><RESOURC E><RESOURCE_URL >/system- manage/resource/t est</RESOURCE_U RL><RESOURCE_CO DE>resourceTest</ | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661223370182 | Number | 时间戳 |
+| status | 1 | Number | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | Object | 堆栈消息 |
+| path | /webapi/ou/sync/resource | String | api 路径 |
+| data | 1 | String | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | String | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661223370182,
+"status": 1,
+"message": "成功",
+页30/276
+"stackmessage": null,
+"path": "/webapi/ou/sync/resource",
+"data": "1",
+"extraInfo":{},
+"success":true
+}
+```
+
+---
+
+### 1.16.4 角色同步
+
+- **接口地址**：`/webapi/ou/sync/role`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`暂无描述`
+- **调试工具**：`ApiPost`
+
+**请求头参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| Content-Type | application/x-www- form-urlencoded | String | 是 | 暂无描述 |
+| app-key | 05397e1e46394e38 8d531dabcd7a6783 | String | 是 | 暂无描述 |
+| app-token | FI0FTnCXdgWEUkb 0iD3Zk3rOBs+hNPI ykuCcuroyEUc1KwJ nCSGRnntlYBeia1rO I8PjNH1ule/r4UQFx WXlCI+r6Eyvf4hIRX ASMUxsfK8M/S91I Uj9PiL0MPKvAZbqX djUiM5u2HYfEwYy mjsC5rGekp+lcet6J QErVZP4fSw= | String | 是 | 暂无描述 |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| roleInfo | <ROOT><ROLE><O RG_CODE>apiSync Org1</ORG_CODE> <RY_ROLENAME>a | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661223374600 | Number | 时间戳 |
+| status | 1 | Number | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | Object | 堆栈消息 |
+| path | /webapi/ou/sync/role | String | api 路径 |
+| data | 1 | String | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | String | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661223374600,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/webapi/ou/sync/role",
+"data": "1",
+"extraInfo":{},
+"success":true
+}
+```
+
+---
+
+### 1.16.5 资源权限同步
+
+- **接口地址**：`/webapi/ou/sync/assign`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`暂无描述`
+- **调试工具**：`ApiPost`
+
+**请求头参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| Content-Type | application/x-www- form-urlencoded | String | 是 | 暂无描述 |
+| app-key | 05397e1e46394e38 8d531dabcd7a6783 | String | 是 | 暂无描述 |
+| app-token | FI0FTnCXdgWEUkb 0iD3Zk3rOBs+hNPI ykuCcuroyEUc1KwJ nCSGRnntlYBeia1rO I8PjNH1ule/r4UQFx WXlCI+r6Eyvf4hIRX ASMUxsfK8M/S91I Uj9PiL0MPKvAZbqX djUiM5u2HYfEwYy mjsC5rGekp+lcet6J QErVZP4fSw= | String | 是 | 暂无描述 |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| assignInfo | <ROOT><Assign><R ESOURCE_URL>/sys tem- manage/resource/t est</RESOURCE_U RL><RY_ROLECODE >apiSyncRole1</RY _ROLECODE></Assi gn></ROOT> | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661223379778 | Number | 时间戳 |
+| status | 1 | Number | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | Object | 堆栈消息 |
+| path | /webapi/ou/sync/assign | String | api 路径 |
+| data | 1 | String | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | String | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661223379778,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/webapi/ou/sync/assign",
+"data": "1",
+"extraInfo":{},
+"success":true
+}
+```
+
+---
+
+## 💡 使用建议
+- **5 个同步接口已全部齐全**：`org`（组织）、`user`（人员）、`resource`（资源）、`role`（角色）、`assign`（资源权限分配）
+- 所有同步接口走 **XML 字符串**作为请求体（如 `<ROOT><USER>...</USER></ROOT>`），属于传统 WebService 风格，需用 `Content-Type: application/x-www-form-urlencoded`
+- 鉴权靠 `app-key` + `app-token`（SM2 加密的 token），由平台在 Nacos 中预先配置，第三方系统需联系平台管理员申请
+- 推荐同步顺序：**组织 → 角色 → 资源 → 资源权限 → 人员**，避免外键依赖报错
+
+## 🔗 相关章节
+- [18_目录与文档说明](./18_目录与文档说明.md)
+- 同目录内其他 1.x 接口见 19/20/21

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/23_1.17/350/265/204/346/272/220/346/225/260/346/215/256/345/257/206/347/272/247-/344/270/212/345/215/212.md

@@ -0,0 +1,303 @@
+---
+name: 资源数据密级-上半（1.17.1-1.17.4）
+source-file: 外部接口清单
+source-section: 1 基础配置 → 1.17 资源数据密级 → 1.17.1–1.17.4
+keywords: [数据密级, secretCode, 数据密级范围, 数据密级配置, 人员数据资源关联, 数据密级配置查询]
+use-cases: [数据密级过滤配置, 人员/资源/数据密级映射]
+related: [10, 24]
+---
+
+# 资源数据密级-上半（1.17.1-1.17.4）
+
+> **原文章节**：外部接口清单 → 1 基础配置 → 1.17 资源数据密级 → 1.17.1–1.17.4
+> **行号范围**：L1512–L1784
+
+## 🎯 一句话
+数据密级相关的 4 个核心接口：数据密级范围、密级配置、密级关联关系、按用户获取密级配置，覆盖密级标签展示与密级匹配。
+
+## 📋 接口清单
+
+---
+
+## 1.17 资源数据密级
+
+---
+
+### 1.17.1 数据密级范围
+
+- **接口地址**：`/certificate/get-data-secret-scope`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`数据密级范围`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661157422548 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /certificate/get-data-secret- scope | String | api 路径 |
+| data |  | Object | 返回数据 |
+| data.baseInfo | {} | Object | 暂无描述 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1716879922523,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/certificate/get-data-secret-scope",
+"data": [
+{
+"id": "3f2882ae7234c27602723541ecf6010c",
+"code": "1",
+"name": "非密",
+"lookupType": "lookupitem",
+"pid": "DE1D5CEB713645E79CC26AC9997F0798",
+"remark": "",
+"enable": "1",
+"sortno": 1,
+"lookupTypeName": "字典值",
+"createUserName": "system",
+"modifyUserName": "zx",
+"tenantId": "",
+"children": null,
+"a":"",
+"b": "",
+"c": "",
+"d": "",
+"e": "",
+"f": "",
+"g": "",
+"h": "",
+"i": "",
+"j": "",
+"k":"",
+"l": "",
+"m": "",
+"n": "",
+"o": "",
+"p": "",
+"q": "",
+"r": "",
+"s": "",
+"t": "",
+"u": "",
+"v": "",
+"w": "",
+"x":"",
+页35/276
+"y":"",
+"z": ""
+}
+```
+
+---
+
+### 1.17.2 数据密级配置
+
+- **接口地址**：`/certificate/get-secret-relation`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`数据密级配置`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661157422548 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | / certificate/get-secret- relation | String | api 路径 |
+| data |  | Object | 返回数据 |
+| data.baseInfo | {} | Object | 暂无描述 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1716884600193,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/certificate/get-secret-relation",
+"data":{
+"usePlatformSecret":true,
+"platformSecret": "secret30",
+页36/276
+"platformSecretName": "机密",
+"empDataSecret":true,
+"resourceDataSecret":true,
+"dataSecretCode": "",
+"dataSecretName": "",
+"secretConfig":{
+"fileLabelFlag": "2",
+"labelPositon": "0",
+"lableRuleArray": [
+{
+"pre": "————",
+"suf": "]",
+"sortNo": 6
+},
+{
+"pre": "【4",
+"suf": "】",
+"sortNo": 10
+},
+{
+"pre": "@",
+"suf": "@@",
+"sortNo": 10
+},
+{
+"pre": "",
+"suf": "———",
+"sortNo": 10
+},
+{
+"pre": "————",
+"suf": "",
+"sortNo": 10
+},
+{
+"pre": "++！@",
+"suf": "%……&",
+"sortNo": 10
+},
+{
+"pre": "",
+"suf": "",
+"sortNo": 10
+}
+```
+
+---
+
+### 1.17.3 人员、数据、资源关联关系
+
+- **接口地址**：`/certificate/get-secret-info-relation`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`获取人员、数据、资源三者的关系`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661157422548 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /certificate/get-secret-info- relation | String | api 路径 |
+| data |  | Object | 返回数据 |
+| data.baseInfo | {} | Object | 暂无描述 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1716884909207,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/certificate/get-secret-info-relation",
+"data":{
+"empResourceList": [
+{
+"id": "8a74dd368f99b989018f99f07a940034",
+"empSecret": "4",
+页38/276
+"resourceSecret": "secret20"
+},
+{
+"id": "8a74dd368f99b989018f99f07aa1003b",
+"empSecret": "3",
+"resourceSecret": "secret10"
+},
+{
+"id": "8a74dd368f99b989018f99f07ace003d",
+"empSecret": "2",
+"resourceSecret": "secret10"
+},
+{
+"id": "8a74dd368f99b989018f99f07ade003f",
+"empSecret": "1",
+"resourceSecret": "secret10"
+},
+{
+"id": "8a74dd368f9abafd018f9b0b1cd20065",
+"empSecret": "cc",
+"resourceSecret": "secret10"
+}
+```
+
+---
+
+### 1.17.4 获取数据密级配置
+
+- **接口地址**：`/certificate/ get-anon-secret-relation`
+- **请求类型**：`application/x-www-form-urlencoded; charset=UTF-8`
+- **请求方式**：`post`
+- **接口备注**：`获取数据密级配置`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| userName | admin | String | 是 | 用户名 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661157422548 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | / certificate/get-anon-secret- relation | String | api 路径 |
+| data |  | Object | 返回数据 |
+| extraInfo |  | Object | 扩展信息 |
+---
+
+## 💡 使用建议
+- 1.17.1 `get-data-secret-scope` 返回平台支持的密级列表（如：非密/内部/秘密/机密/绝密），前端用来展示密级下拉选项
+- 1.17.2 `get-secret-relation` 返回的 `secretConfig.lableRuleArray` 控制文件标签前后缀格式
+- 1.17.3 关联关系是 N:N（一对多），人员密级 `empSecret` 与资源密级 `resourceSecret` 配对生效
+- 1.17.4 按用户名（`userName`）查询，适用于匿名/未登录场景的密级过滤
+
+## 🔗 相关章节
+- [24_1.17资源数据密级-下半](./24_1.17资源数据密级-下半.md)
+- [19_1.1-1.6基础配置-平台信息类](./19_1.1-1.6基础配置-平台信息类.md)（1.5 平台密级）