API 约定

公开 API 基础地址：

https://account.ylfcat.top/api/v1

• 请求与响应使用 UTF-8 JSON。
• 受保护接口使用 Authorization: Bearer <access_token>。
• 数据库存储 UTC，时间字段使用 RFC 3339 字符串。
• 客户端必须忽略未知响应字段，以便兼容向后扩展。
• 管理后台接口不属于公开 API，不在此文档承诺兼容性。

需要分页的列表响应统一为：

{
  "items": [],
  "total": 0,
  "page": 1,
  "pageSize": 20
}

不分页的轻量目录接口（例如 /sites）只返回 items。

使用 Accept: application/json。带 JSON 请求体时同时设置 Content-Type: application/json。