API 概览

SuperUser 提供 RESTful API，支持对所有模型数据进行程序化操作。

认证

所有 API 请求需在请求头中携带 API Token：

Authorization: Bearer <your-api-token>

API Token 可在【设置 → 个人设置 → API 访问】中生成。

基础 URL

http(s)://your-superuser-domain/api/v1

通用响应格式

{
  "success": true,
  "data": { ... },
  "total": 100,
  "page": 1,
  "pageSize": 20
}

速率限制

默认每个 API Token 每分钟最多 1000 次请求。超出限制返回 429 Too Many Requests。