docs: 更新 API.md — Manifest ETag + /time 接口
This commit is contained in:
20
docs/API.md
20
docs/API.md
@@ -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": {
|
||||
|
||||
Reference in New Issue
Block a user