diff --git a/docs/API.md b/docs/API.md
index 98bf8a1..639846e 100644
--- a/docs/API.md
+++ b/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": {