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

package/skills/meritdata-platform-integration/references/external-api/full/20_1.7-1.10/345/237/272/347/241/200/351/205/215/347/275/256-/351/241/265/351/235/242/344/270/216/346/266/210/346/201/257/347/261/273.md

@@ -0,0 +1,344 @@
+---
+name: 基础配置-页面与消息类（1.7-1.10）
+source-file: 外部接口清单
+source-section: 1 基础配置 → 1.7–1.10
+keywords: [tagimage, 登录页超链接, tempo授权, 保存消息, 消息发送, 系统管理员]
+use-cases: [登录页定制, tempo平台首页授权, 消息发送]
+related: [19, 21]
+---
+
+# 基础配置-页面与消息类（1.7-1.10）
+
+> **原文章节**：外部接口清单 → 1 基础配置 → 1.7–1.10
+> **行号范围**：L628–L940
+
+## 🎯 一句话
+平台页面定制与消息发送类接口：tag/image 获取、登录页超链接、tempo 授权信息、保存和发送消息。
+
+## 📋 接口清单
+
+---
+
+## 1.7 tagimage 获取和
+
+- **接口地址**：`/certificate/get-tag-image`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`获取tag 和image`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661157807373 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /certificate/get-tag-image | String | api 路径 |
+| data |  | Object | 返回数据 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661157807373,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/certificate/get-tag-image",
+"data": "",
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+## 1.8 获取登录页超链接名称和地址
+
+- **接口地址**：`/certificate/getLoginInfo`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`获取登录页超链接名称和地址`
+- **调试工具**：`ApiPost`
+
+**URI 参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| type | String | String | 否 | type |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+
+**返回成功示例**：
+
+```json
+{
+"isAddHref": "1",
+"name": "http://191.168.7.25:8080/portal/#/login",
+"addr": ""
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+## 1.9 tempo 授权信息首页加载使用
+
+- **接口地址**：`/certificate/product`
+- **请求类型**：`application/json`
+- **请求方式**：`post`
+- **接口备注**：`授权信息tempo 首页加载使用`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+
+**返回成功示例**：
+
+```json
+{
+"cloud-system":{
+"isGranted":true,
+"modules": [
+"systembase",
+"redevelp",
+"tenancy",
+"bpm",
+"mon"
+]
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 授权信息首页加载使用
+
+- **接口备注**：`授权信息tempo 首页加载使用`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+
+**返回成功示例**：
+
+```json
+{
+"cloud-system":{
+"isGranted":true,
+"modules": [
+"systembase",
+"redevelp",
+"tenancy",
+"bpm",
+"mon"
+]
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+## 1.10 保存和发送消息
+
+- **接口地址**：`/api/announcement/addSendMessage`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`保存和发送消息`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| receiverName | sadasd | String | 是 | 暂无描述 |
+| receiverId | 3d6887c59b564289 9425ea21202287b8 | String | 是 | 暂无描述 |
+| title | test | String | 是 | 暂无描述 |
+| msgType | 0 | String | 是 | 暂无描述 |
+| isModel | 0 | String | 是 | 暂无描述 |
+| detailContent | <p>test001</p> | String | 是 | 暂无描述 |
+| senderId | admin | String | 是 | 暂无描述 |
+| senderName | 系统管理员 | String | 是 | 暂无描述 |
+| isSend | 1 | String | 是 | 暂无描述 |
+| timeSend | 1 | String | 是 | 暂无描述 |
+| isTimer | 0 | String | 是 | 暂无描述 |
+| cronConfig | %7B%22cron%22% 3A%22%22%2C%22 stopTime%22%3A% 22Mon%20Aug%20 22%202022%2016 %3A37%3A42%20G MT%2B0800%20(% E4%B8%AD%E5%9 B%BD%E6%A0%87 %E5%87%86%E6% 97%B6%E9%97%B4 | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661219912113 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/announcement/addSend Message | String | api 路径 |
+| data |  | 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": 1661219912113,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/announcement/addSendMessage",
+"data":{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": null,
+"updateTime": 1661219912097,
+"creatorId": null,
+"reviserId": null,
+"id": "3f2883b282c4c2cd0182c86c39b10096",
+"isSend": "1",
+"msgType": "0",
+"title": "test",
+"senderId": "admin",
+"senderName": "系统管理员",
+"sendTime": 1661219912098,
+"isRead": "0",
+"detailContent": "test001",
+页 18/276
+"receiverId": "3d6887c59b5642899425ea21202287b8",
+"receiverName": "sadasd",
+"receiverSessionId": null,
+"showType": null,
+"url": null,
+"enclosureIds": null,
+"isModel": "0",
+"isTimer": "0",
+"cronConfig":
+"%7B%22cron%22%3A%22%22%2C%22stopTime%22%3A%22Mon%20Aug%20
+22%202022%2016%3A37%3A42%20GMT%2B0800%20(%E4%B8%AD%E5%9B%
+BD%E6%A0%87%E5%87%86%E6%97%B6%E9%97%B4)86400000%22%2C%22m
+oreTimeType%22%3A%220%22%2C%22radio%22%3A%221%22%7D",
+"timeSend": "1"
+},
+"extraInfo":{},
+"success":true
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 系统管理员
+
+## 💡 使用建议
+- 1.7 用于平台 Logo/Tag 二维码图片展示，data 字段为 base64 字符串
+- 1.9 接口返回的 `modules` 数组决定了 tempo 平台左侧菜单是否显示（`systembase/redevelp/tenancy/bpm/mon`）
+- 1.10 消息接口支持定时发送（`isTimer=1` + `cronConfig`），定时规则为 URL 编码的 JSON
+
+## 🔗 相关章节
+- [19_1.1-1.6基础配置-平台信息类](./19_1.1-1.6基础配置-平台信息类.md)
+- [21_1.11-1.15基础配置-消息与配置类](./21_1.11-1.15基础配置-消息与配置类.md)

package/skills/meritdata-platform-integration/references/external-api/full/21_1.11-1.15/345/237/272/347/241/200/351/205/215/347/275/256-/346/266/210/346/201/257/344/270/216/351/205/215/347/275/256/347/261/273.md

@@ -0,0 +1,302 @@
+---
+name: 基础配置-消息与配置类（1.11-1.15）
+source-file: 外部接口清单
+source-section: 1 基础配置 → 1.11–1.15
+keywords: [消息已读未读, 消息详情, 保存信息, 首页框架配置, 角色跳转]
+use-cases: [消息中心, 首页框架配置, 角色路由]
+related: [19, 20]
+---
+
+# 基础配置-消息与配置类（1.11-1.15）
+
+> **原文章节**：外部接口清单 → 1 基础配置 → 1.11–1.15
+> **行号范围**：L941–L1215
+
+## 🎯 一句话
+平台消息中心与首页框架配置类接口：已读未读消息统计、消息详情、保存草稿、首页框架配置、登录角色路由。
+
+## 📋 接口清单
+
+---
+
+## 1.11 获取管理页面已读未读消息
+
+- **接口地址**：`api/announcement/getMessageCount?param=Object`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`获取管理页面已读未读消息`
+- **调试工具**：`ApiPost`
+
+**URI 参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| param | Object | Object | 是 | param |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| id |  | String | 是 | 暂无描述 |
+| code | B10BCB7828890E9 D9AB1459EAA5009 BA | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"hasSendCount":0,
+"timerCount":0,
+"notReadTip":3,
+"messageCount":3,
+"messageCountTip":3,
+"notSendCount":0,
+"notRead":3,
+"hasRead":0,
+"modelCount":0
+}
+```
+
+---
+
+## 1.12 获取发送信息详情
+
+- **接口地址**：`/api/announcement/getMessageInfor`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`获取发送信息详情`
+- **调试工具**：`ApiPost`
+
+**URI 参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| id | String | String | 否 | id |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| id | 3f2883b282c4c2cd 0182c85af46f0083 | String | 是 | 暂无描述 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+
+**返回成功示例**：
+
+```json
+{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": null,
+"updateTime": 1661218780000,
+"creatorId": null,
+"reviserId": null,
+"id": "3f2883b282c4c2cd0182c85af46f0083",
+"isSend": "1",
+"msgType": "0",
+"title": "test",
+"senderId": "admin",
+"senderName": "系统管理员",
+"sendTime": 1661218780000,
+"isRead": "0",
+"detailContent": "test001",
+"receiverId": "3d6887c59b5642899425ea21202287b8",
+"receiverName": "sadasd",
+"receiverSessionId": null,
+"showType": null,
+"url": null,
+"enclosureIds": null,
+"isModel": "0",
+"isTimer": "0",
+"cronConfig": "{\"cron\":\"\",\"stopTime\":\"MonAug222022
+16:37:42GMT+0800 (中国标准时
+间)86400000\",\"moreTimeType\":\"0\",\"radio\":\"1\"}",
+"timeSend": "1"
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+## 1.13 保存信息
+
+- **接口地址**：`/api/announcement/saveMessage`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`保存信息`
+- **调试工具**：`ApiPost`
+
+**URI 参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| detailContent | String | String | 否 | detailContent |
+| msgType | String | String | 否 | msgType |
+| receiverIds | String | String | 否 | receiverIds |
+| senderId | String | String | 否 | senderId |
+| title | String | String | 否 | title |
+| url | String | String | 否 | url |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| receiverId | 3d6887c59b564289 9425ea21202287b8 | String | 是 | 暂无描述 |
+| title | test | String | 是 | 暂无描述 |
+| msgType | 0 | String | 是 | 暂无描述 |
+| detailContent | <p>test001</p> | String | 是 | 暂无描述 |
+| senderId | admin | String | 是 | 暂无描述 |
+| url | wwwwww | 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":{}}
+```
+
+---
+
+## 1.14 查询首页框架配置接口
+
+- **接口地址**：`/api/basic/home-frame-config/find`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`查询首页框架配置接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": null,
+"updateTime": 1661222511243,
+"creatorId": null,
+"reviserId": null,
+"id": null,
+"name": "首页",
+页23/276
+"status": null,
+"type": "mixture",
+"theme": "green",
+"showMenuTab":false,
+"showFirstMenuIcon":true,
+"showShortCutIcon":true,
+"showShortCutName":true,
+"indexUrl": "views/system/index.vue",
+"authObjs": null,
+"customLogo":false,
+"icon": "el-icon-setting"
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+## 1.15 根据不同登录角色跳转至不同的地址页面
+
+- **接口地址**：`/api/basic/home-frame-config/get-role-home-url`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`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":{}}
+```
+
+---
+
+## 💡 使用建议
+- 1.11 返回的 9 个计数字段覆盖"已发送/草稿/未读/定时/模板"等所有消息状态，前端首页红点提醒用
+- 1.14 返回的 `theme/showMenuTab/showFirstMenuIcon` 字段控制首页视觉风格
+- 1.15 用于多角色平台下，不同角色登录后跳转到不同首页（如管理员进运维面板、普通用户进业务首页）
+
+## 🔗 相关章节
+- [19_1.1-1.6基础配置-平台信息类](./19_1.1-1.6基础配置-平台信息类.md)
+- [20_1.7-1.10基础配置-页面与消息类](./20_1.7-1.10基础配置-页面与消息类.md)