基础 URL
托管服务：http://localhost:3005）。
认证
大多数端点需要在Authorization 请求头中使用 Bearer 令牌进行认证：
认证工作原理
- 在设备上生成 Ed25519 密钥对
- 将公钥和签名后的挑战值发送到
POST /v1/auth - 服务端验证签名并返回 JWT 令牌
- 在后续所有请求中携带此令牌
请求格式
- 内容类型：
application/json - 所有时间戳为 ISO 8601 字符串或 Unix 毫秒时间戳
- ID 为字符串格式（CUID2）
响应格式
成功响应直接返回数据。错误响应返回包含error 字段的 JSON 对象：
常见状态码
| 状态码 | 含义 |
|---|---|
200 | 成功 |
201 | 已创建 |
400 | 请求错误（参数无效） |
401 | 未认证（缺少或无效的令牌） |
403 | 禁止访问（权限不足） |
404 | 未找到 |
500 | 服务器错误 |