docs: 完善接口文档可用性说明,补充 PAR Server 整体不可用时的 CDN fallback 方案

This commit is contained in:
mediabot-pt
2026-07-07 11:18:15 +08:00
parent c823878ae0
commit a92ddccc46

View File

@@ -67,10 +67,16 @@ ETag: "abc123def456..."
```
_(Body 为空,节省带宽)_
**可用性保障**:
- 优先从 MySQL 数据库读取
- 数据库不可用时自动回退到七牛云 CDN `snapshots/{siteId}.json`
- 两层级联失败返回 500
**可用性保障**(PAR Server 端三层级联):
- 第一层:优先从 MySQL 数据库读取
- 第二层:数据库异常时自动回退到七牛云 CDN `snapshots/{siteId}.json`
- 第三层:CDN 也无数据时,实时构建(从各子表 + 七牛云存储拼装)
- 全部失败返回 500
**MediaBot 端建议**(应对 PAR Server 整体不可用):
- MediaBot 应缓存每个站点的 CDN URL(`https://{七牛云CDN域名}/snapshots/{siteId}.json`)
- 当 PAR Server 连接超时/拒绝连接时,直接请求 CDN URL 作为终极 fallback
- 这样即使 PAR Server 宕机,配置仍可通过 CDN 获取(每次 publish 都会同步上传到 CDN)
---
@@ -189,7 +195,9 @@ MediaBot 启动 / 定时任务:
```
1. 优先调用新接口 GET /api/v1/snapshots/{siteId}
2. 失败时 fallback 到旧接口组合:
2. PAR Server 不可用时 fallback 到 CDN:
- 直接 GET https://{CDN域名}/snapshots/{siteId}.json
3. CDN 也无数据时 fallback 到旧接口组合:
- GET /api/v1/configs/{siteId}/script
- GET /api/v1/sites/{siteId}/pages
- GET /api/v1/risk-rules/{siteType}