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 | `/health` | 无 | 健康检查 |
|
||||||
| GET | `/api/v1/time` | 无 | 服务端时间戳(秒) |
|
| GET | `/api/v1/time` | 无 | 服务端时间戳,签名前获取避免时钟偏差 |
|
||||||
|
|
||||||
|
#### GET /api/v1/time
|
||||||
|
|
||||||
|
```json
|
||||||
|
// Response 200
|
||||||
|
{ "timestamp": 1782800000, "unit": "seconds" }
|
||||||
|
```
|
||||||
|
|
||||||
### 2.2 认证
|
### 2.2 认证
|
||||||
|
|
||||||
@@ -115,8 +122,17 @@ Token 通过 `POST /api/v1/auth/login` 获取,24 小时有效。
|
|||||||
|
|
||||||
#### GET /api/v1/manifest
|
#### 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
|
```json
|
||||||
// Response 200
|
// Response 200 ETag: "a1b2c3d4..."
|
||||||
{
|
{
|
||||||
"code": 200,
|
"code": 200,
|
||||||
"data": {
|
"data": {
|
||||||
|
|||||||
Reference in New Issue
Block a user