Skip to main content
自己管理 API 密钥。创建或列出密钥需要 admin 主体(引导密钥 AGENT_CLOUD_API_KEY,或带 admin 作用域的密钥)。明文密钥只在创建响应里出现。

创建 API 密钥

接口

认证

Authorization: Bearer <api_key> 或 Authorization: ApiKey <key>,且需 admin 作用域。

请求体

string
密钥的人类可读标签(可选)。
string
这个密钥对应的租户/用户。省略时自动生成 UUID,必须是 1–64 个 ASCII 字母数字、_ 或 -。
array
作用域:read、write、admin。默认 ["read","write"]。admin 包含读写。

响应

string
密钥 id,吊销时用。
string
明文密钥(aria-…),只显示这一次,请立刻保存。
string
密钥的短显示前缀。
string
这个密钥对应的主体。
array
实际生效的作用域。

列出 API 密钥

接口

返回未吊销密钥的 JSON 数组,需要 admin 作用域。明文密钥永远不列出。

响应

每个元素:
string
密钥 id。
string
显示前缀。
string
绑定的主体。
string
可选标签。
array
作用域令牌。
string
Postgres 中的创建时间戳。