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

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/39_3.12/346/225/260/346/215/256/346/272/220/347/273/264/346/212/244.md

@@ -0,0 +1,277 @@
+---
+name: 3.12 数据源维护
+source-file: 外部接口清单
+source-section: 3.12 数据源维护
+keywords: [数据源维护, 数据源创建, 数据源删除, 启用数据源]
+use-cases: [动态数据源管理]
+related: [38_3.11基础数据.md]
+---
+
+# 3.12 数据源维护
+
+> **原文章节**：`外部接口清单 → 3.12 数据源维护`
+> **行号范围**：L9357-L9607
+
+## 🎯 一句话
+本章节提供数据源名称前缀生成、数据源删除以及已启用数据源列表查询接口。
+
+## 📋 接口清单
+
+## 3.12 数据源维护
+
+---
+
+### 3.12.1 创建数据源前缀
+
+- **接口地址**：`/api/basic/datasource/create-name?prefix=test`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`暂无描述`
+- **调试工具**：`ApiPost`
+
+**URI 参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| prefix | test | String | 否 | 数据源名称前缀 |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661223207487 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/basic/datasource/create- name | String | api 路径 |
+| data | test_0 | Object | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661223207487,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+页 202/276
+"path": "/api/basic/datasource/create-name",
+"data": "test_0",
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 3.12.2 DF 空间数据源删除
+
+- **接口地址**：`/api/basic/datasource/delete?id=3f2883b2821950330182199cb96e0096`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`暂无描述`
+- **调试工具**：`ApiPost`
+
+**URI 参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| id | 3f2883b282195033 0182199cb96e0096 | String | 否 | 数据源的 ID |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661223763159 | 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": 1661223763159,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/basic/datasource/delete",
+"data": null,
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 3.12.3 获取已启用的数据源列表
+
+- **接口地址**：`/api/basic/datasource/enable-list`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`暂无描述`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| keyword | fdsf | String | 否 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661250740758 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/basic/datasource/enable- list | 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": 1661250740758,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/basic/datasource/enable-list",
+"data": [
+{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": 1661150631000,
+"updateTime": 1661150631000,
+"creatorId": "admin",
+"reviserId": null,
+"id": "9fdea0f5c54745c9a4cf0bd933e3e78f",
+"name": "dsfdsffdfsdafdfasdf",
+"code": "9fdea0f5c54745c9a4cf0bd933e3e78f",
+"type": "webapi",
+"canReadAndWrite": null,
+"description": "sdfsdfsdd",
+"url": "jdbc:api:http://:/",
+"userName": "",
+"password": "",
+"customPwd": null,
+"status": "0",
+"maxActive": "1000",
+"minActive": null,
+页 205/276
+"initialSize": "5",
+"maxWait": "5",
+"maxIdle": "5",
+"isModel": 1,
+"sourceCode": null,
+"info":
+"{\"apiMetaDataImpl\":\"com.meritdata.tempo.datasource.type.webapi.met
+adata.WebApiMetaDataHanlder\",\"type\":\"form\",\"params\":{},\"script\":
+\"\"}",
+"otherParams":
+"{\"type\":\"form\",\"params\":{},\"script\":\"\"}",
+"dataSourceType": "0",
+"workSpaceId": null,
+"classifyId": "ff8080818286c010018287ce5e510031",
+"purpose": "0",
+"port": null,
+"ip": null,
+"createDept": "1",
+"modifyDept": null,
+"createOrg": "1",
+"sid": "",
+"toSchema": "",
+"dataName": "",
+"modelName": null,
+"cluster": null,
+"tls": null,
+"caPath": null,
+"clientPath": null,
+"privateKeyPath": null,
+"privateKeyPass": "",
+"dbVersion": null,
+"exteralParams": null,
+"thirdTypeName": null,
+"alias": null,
+"category": null,
+"minImage": null,
+"module": null,
+"model":true,
+"dynimicPwd":false
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+
+## 💡 使用建议
+- 创建数据源名称前缀和删除 ID 应分别进行格式校验，避免误删数据源。
+- 启用数据源列表可能返回连接配置字段，展示或记录时应注意敏感信息保护。
+
+## 🔗 相关章节
+- 38_3.11基础数据.md

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/40_3.13/347/254/254/344/270/211/346/226/271/350/265/204/346/272/220/347/273/264/346/212/244.md

@@ -0,0 +1,310 @@
+---
+name: 3.13 第三方资源维护
+source-file: 外部接口清单
+source-section: 3.13 第三方资源维护
+keywords: [第三方资源, DAM, 资源新增, 资源删除]
+use-cases: [DAM外部资源管理]
+related: [41_3.14服务管理.md]
+---
+
+# 3.13 第三方资源维护
+
+> **原文章节**：`外部接口清单 → 3.13 第三方资源维护`
+> **行号范围**：L9608-L9891
+
+## 🎯 一句话
+本章节提供 DAM 第三方资源的新增、删除、列表查询和更新接口。
+
+## 📋 接口清单
+
+## 3.13 第三方资源维护
+
+---
+
+### 3.13.1
+
+- **接口地址**：`/api/authority/external/create`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`新增资源接口`
+---
+
+### 新增资源接口
+
+- **接口备注**：`新增资源接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| name | ssss | String | 是 | 暂无描述 |
+| code | 222 | String | 是 | 暂无描述 |
+| addr | https://baidu.com m | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661246140654 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/authority/external/create | 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": 1661246140654,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/authority/external/create",
+"data":{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": 1661246140573,
+"updateTime": 1661246140573,
+"creatorId": null,
+"reviserId": null,
+"id": "3aa2845f8ab4497290af76f1f8095084",
+"name": "ssss",
+"code": "222",
+"addr": "https://baidu.comm",
+"type": null,
+"expression": null
+},
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 3.13.2
+
+- **接口地址**：`/api/authority/external/delete`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`删除资源接口`
+---
+
+### 删除资源接口
+
+- **接口备注**：`删除资源接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| ids | 3f2883b282c4c2cd 0182c9fdba7d01a1 | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661246253126 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/authority/external/delete | String | api 路径 |
+| data | 删除成功！ | String | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+---
+
+### 删除成功！
+
+### 3.13.3
+
+- **接口地址**：`/api/authority/external/lists`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`查询资源列表接口`
+---
+
+### 查询资源列表接口
+
+- **接口备注**：`查询资源列表接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| page | 1 | String | 是 | 分页页码，数字类型 |
+| rows | 10 | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661246348428 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/authority/external/lists | 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": 1661246348428,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/authority/external/lists",
+"data":{
+"rows": [
+{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+页 210/276
+"createTime": 1661246088000,
+"updateTime": 1661246088000,
+"creatorId": null,
+"reviserId": null,
+"id": "3f2883b282c4c2cd0182c9fba5700194",
+"name": "sdsd",
+"code": "dsd",
+"addr": "https://baidu.comm",
+"type": null,
+"expression": null
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 3.13.4
+
+- **接口地址**：`/api/authority/external/update`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`更新资源接口`
+---
+
+### 更新资源接口
+
+- **接口备注**：`更新资源接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| id | 3f28832d80218140 01802188124f0004 | String | 是 | 暂无描述 |
+| name | 问问 | String | 是 | 暂无描述 |
+| code | asa | String | 是 | 暂无描述 |
+| addr | http://baidu.com | String | 是 | 暂无描述 |
+| type |  | String | 否 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661246376761 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/authority/external/update | 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": 1661246376761,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/authority/external/update",
+"data":{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": 1649830007000,
+"updateTime": 1661246376709,
+"creatorId": null,
+"reviserId": null,
+"id": "3f28832d8021814001802188124f0004",
+"name": "问问",
+"code": "asa",
+"addr": "http://baidu.com",
+页 212/276
+"type": "",
+"expression": ""
+},
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+
+## 💡 使用建议
+- 新增和更新资源时校验 name、code、addr 等必填字段及地址格式。
+- 删除资源前确认 ids 对应的资源范围，并根据返回结果处理失败情况。
+
+## 🔗 相关章节
+- 41_3.14服务管理.md