26 lines
569 B
Markdown
26 lines
569 B
Markdown
# 接口文档
|
|
|
|
服务根路径：`/api/v1`
|
|
|
|
## 用户资源
|
|
|
|
### 获取用户列表
|
|
|
|
- 请求：`GET /api/v1/users`
|
|
- 响应：`200 OK`
|
|
|
|
```json
|
|
[{"id":"uuid","name":"示例用户","email":"demo@example.com","createdAt":"2026-08-23T00:00:00.000Z","updatedAt":"2026-08-23T00:00:00.000Z"}]
|
|
```
|
|
|
|
### 创建用户
|
|
|
|
- 请求：`POST /api/v1/users`
|
|
- 请求体：`name` 为 1 至 50 个字符，`email` 必须为邮箱格式。
|
|
- 响应：`201 Created`
|
|
- 冲突：邮箱已经存在时返回 `409 Conflict`。
|
|
|
|
```json
|
|
{"name":"示例用户","email":"demo@example.com"}
|
|
```
|