datai-vue/doc/salesforce/integration/RealtimeServiceController/0001-get-status.md
Kris 1177dbde35 feat: 添加元数据变更中心和实时同步统计页面
- 新增元数据变更中心页面 (metadatachange/index.vue)
  - 集成统计卡片显示变更数据
  - 支持按变更类型、操作类型、同步状态分组统计
  - 支持趋势统计图表展示
  - 优化查询条件布局,移至页面顶部

- 新增实时同步统计页面 (statistics/realtime/index.vue)
  - 显示实时同步服务状态和控制按钮
  - 统计启用实时同步的对象数量
  - 自动刷新统计数据(30秒间隔)

- 优化数据同步页面 (datasync/index.vue)
  - 修正字段映射以匹配API响应
  - 更新统计卡片显示实际数据

- 优化同步日志统计页面 (statistics/synclog/index.vue)
  - 更新表格列以匹配API响应结构
  - 更新查询参数和映射函数

- 更新导航栏菜单 (Navbar/index.vue)
  - 添加元数据变更中心菜单项

- 新增API接口 (realtimeservice.js)
  - 添加getStatistics函数获取实时同步统计数据

- 新增接口文档
  - DataiIntegrationRealtimeSyncController 接口文档
  - DataiIntegrationRealtimeSyncLogController 接口文档
2026-01-13 13:50:07 +08:00

108 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 获取实时服务状态
## 接口概述
获取 Salesforce 实时同步服务的当前运行状态,包括对象注册表、事件订阅和实时同步服务的状态信息。
## 接口详情
- **接口名称**: 获取实时服务状态
- **接口路径**: `/integration/realtime/service/status`
- **请求方法**: `GET`
- **权限标识**: `integration:realtime:status`
- **接口标签**: 【实时服务管理】统一管理
## 请求参数
### Headers
| 参数名 | 类型 | 必填 | 描述 |
|--------|------|------|------|
| Authorization | String | 是 | 认证令牌格式Bearer {token} |
### Query Parameters
### Body Parameters
## 响应参数
### 响应结构
```json
{
"success": boolean,
"message": String,
"status": {
"objectRegistryInitialized": boolean,
"registeredObjectCount": number,
"eventSubscriberStarted": boolean,
"realtimeSyncServiceStarted": boolean
}
}
```
### 字段说明
| 字段名 | 类型 | 描述 |
|--------|------|------|
| success | Boolean | 请求是否成功true-成功false-失败 |
| message | String | 响应消息,描述操作结果 |
| status | Object | 实时服务状态对象 |
| status.objectRegistryInitialized | Boolean | 对象注册表是否已初始化 |
| status.registeredObjectCount | Number | 已注册的对象数量 |
| status.eventSubscriberStarted | Boolean | 事件订阅是否已启动 |
| status.realtimeSyncServiceStarted | Boolean | 实时同步服务是否已启动 |
## 响应示例
### 成功响应
```json
{
"success": true,
"message": "获取实时服务状态成功",
"status": {
"objectRegistryInitialized": true,
"registeredObjectCount": 15,
"eventSubscriberStarted": true,
"realtimeSyncServiceStarted": true
}
}
```
### 失败响应
```json
{
"success": false,
"message": "获取实时服务状态失败: 系统异常"
}
```
## 错误码说明
| 错误码 | 描述 | 解决方案 |
|--------|------|----------|
| 401 | 未授权token 无效或已过期 | 重新登录获取有效 token |
| 403 | 无权限访问该接口 | 联系管理员分配相应权限 |
| 500 | 服务器内部错误 | 检查服务器日志,联系技术支持 |
## 注意事项
1. 该接口仅用于查询状态,不会对服务进行任何修改
2. 建议在启动或停止服务后调用此接口确认状态
3. 如果所有服务都未启动,需要先调用初始化和启动接口
4. 对象注册表初始化后registeredObjectCount 应大于 0
5. 事件订阅和实时同步服务的启动顺序建议:先初始化对象注册表,再启动事件订阅,最后启动实时同步服务
## 相关接口
- [初始化对象注册表](./0008-init-registry.md)
- [启动事件订阅](./0009-start-subscriber.md)
- [启动实时同步服务](./0011-start-service.md)
- [一键启动所有实时服务](./0013-start-all.md)