SoftUnis
ecb29e0aa4
包含 VitePress 文档站完整源码及全新自定义首页设计： - 自定义首页组件 (Home.vue)：Hero + 终端动效 + 核心能力 + 架构展示 + 快速开始 + CTA - 自定义 Layout.vue：首页/文档页布局切换 - 金铜色品牌主题样式 - 完整文档页面（指南、API、更新日志、演示、社区） - SEO 配置（sitemap、robots、meta 标签）
67 lines
956 B
Markdown
67 lines
956 B
Markdown
# 系统接口
|
||
|
||
## 健康检查
|
||
|
||
检查 PostgreSQL 和 Redis 连接状态。
|
||
|
||
**`GET /health`**
|
||
|
||
无需认证。
|
||
|
||
### 响应
|
||
|
||
```json
|
||
{
|
||
"status": "ok",
|
||
"database": "connected",
|
||
"redis": "connected",
|
||
"timestamp": 1727856000,
|
||
"version": "0.1.0",
|
||
"trace_id": "req-abc-123"
|
||
}
|
||
```
|
||
|
||
### 状态说明
|
||
|
||
| 字段 | 可能值 |
|
||
|------|--------|
|
||
| `status` | `ok` / `degraded` / `down` |
|
||
| `database` | `connected` / `disconnected` |
|
||
| `redis` | `connected` / `disconnected` |
|
||
|
||
---
|
||
|
||
## 连通性测试
|
||
|
||
返回 pong，用于验证认证和多租户中间件是否正常工作。
|
||
|
||
**`GET /api/v1/ping`**
|
||
|
||
需要认证和租户头。
|
||
|
||
### 请求头
|
||
|
||
```
|
||
Authorization: Bearer <access_token>
|
||
X-Tenant-ID: <tenant_id>
|
||
```
|
||
|
||
### 响应
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"message": "success",
|
||
"data": {
|
||
"message": "pong"
|
||
},
|
||
"trace_id": "req-abc-123"
|
||
}
|
||
```
|
||
|
||
### 用途
|
||
|
||
- 验证 Token 是否有效
|
||
- 验证多租户中间件是否正常
|
||
- 客户端心跳检测
|