Skip to main content
MEMO API 用请求头认证。网关接受 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。错误体统一为: