API 概览
REST API 的基础约定、鉴权方式与响应格式。
最后更新于
基础约定
所有接口以 /api 为前缀,语言前缀由国际化中间件处理。请求与响应均为 JSON。
鉴权
登录后服务端会下发会话 Cookie,后续请求自动携带。也可以通过 Authorization 头携带令牌。
响应格式
{
"items": [],
"page": 1,
"pageSize": 20,
"total": 0
}错误处理
| 状态码 | 含义 |
|---|---|
| 400 | 参数错误 |
| 401 | 未登录 |
| 403 | 无权限 |
| 500 | 服务端错误 |
