docs: 统一时间格式为亚洲友好的日期时间字符串

所有文档中的时间字段统一为 yyyy-MM-dd HH:mm:ss 格式(Asia/Shanghai):
- 移除 ISO 8601 格式(2026-02-27T10:00:00Z)
- 移除 Unix 时间戳(1740700000)
- 响应字段从 timestamp(int64) 改为 time(string)
- API README 新增「时间格式规范」章节
- 涉及 10 个文档文件

Made-with: Cursor
This commit is contained in:
bujinyuan
2026-02-28 09:47:42 +08:00
parent 8c4b40b407
commit 44fa5a3830
10 changed files with 42 additions and 27 deletions

View File

@@ -37,6 +37,21 @@
Authorization: Bearer <access_token>
```
### 时间格式规范
系统所有时间字段统一使用 **亚洲友好的日期时间字符串格式**
```
yyyy-MM-dd HH:mm:ss
```
示例:`"2026-03-01 14:12:12"`
- 所有 API 响应中的时间字段(`created_at``updated_at``last_login_at``started_at` 等)均使用此格式
- 所有 API 请求中的时间参数(如预约会议时间)也使用此格式
- WebSocket 消息中的时间字段同样遵循此格式
- 时区统一采用 **Asia/Shanghai (UTC+8)**
### 统一响应格式
**成功响应:**
@@ -45,7 +60,7 @@ Authorization: Bearer <access_token>
"code": 0,
"message": "ok",
"data": { ... },
"timestamp": 1740700000
"time": "2026-02-27 18:00:00"
}
```
@@ -55,7 +70,7 @@ Authorization: Bearer <access_token>
"code": 1001,
"message": "参数错误:邮箱格式不正确",
"data": null,
"timestamp": 1740700000
"time": "2026-02-27 18:00:00"
}
```