Authorization: Bearer <jwt> 或 X-API-Key: <sk_aria_...>,两者等效。未携带任一凭证会返回 401 Unauthorized。
取得凭证
方案 A:账号 + JWT
注册或登录拿到 JWT:token 用作后续请求的 Bearer:
方案 B:API Key
用 JWT 登录后,创建一个 API Key(仅展示一次):X-API-Key 头调用,无需再维护 JWT:
https://memo.ariacompute.com。
工作空间 RBAC
除/v1/auth/* 与 /v1/apikeys 外,所有业务接口都挂在某个工作空间之下,并校验调用者在该空间的角色。角色由低到高:
各接口在「认证」小节标注了所需的最小角色。角色不足返回
403 Forbidden。
错误响应
需要认证但凭证缺失或无效时,API 返回401;角色不足返回 403。错误体统一为: