docs: 更新 API.md — Manifest ETag + /time 接口

This commit is contained in:
mediabot-pt
2026-06-29 17:22:04 +08:00
parent cbf5684abc
commit f247cc15fe

View File

@@ -63,7 +63,14 @@ Token 通过 `POST /api/v1/auth/login` 获取,24 小时有效。
| 方法 | 路径 | 认证 | 说明 |
|------|------|------|------|
| GET | `/health` | 无 | 健康检查 |
| GET | `/api/v1/time` | 无 | 服务端时间戳(秒) |
| GET | `/api/v1/time` | 无 | 服务端时间戳,签名前获取避免时钟偏差 |
#### GET /api/v1/time
```json
// Response 200
{ "timestamp": 1782800000, "unit": "seconds" }
```
### 2.2 认证
@@ -115,8 +122,17 @@ Token 通过 `POST /api/v1/auth/login` 获取,24 小时有效。
#### GET /api/v1/manifest
支持 `If-None-Match` 条件请求(ETag = 所有站点+配置哈希的 SHA-256)。
无变化时返回 `304 Not Modified`,无数据传输。
```bash
# 轮询示例
curl -H "If-None-Match: a1b2c3d4..." http://par:9012/api/v1/manifest
# → 304 Not Modified (内容未变)
```
```json
// Response 200
// Response 200 ETag: "a1b2c3d4..."
{
"code": 200,
"data": {