文档·Auth 与 API 密钥
🔑

Auth 与 API 密钥

Bearer 令牌、密钥轮换、IP 白名单,以及 auth 失败时你会看到的错误。

Bearer 令牌

每个对 https://api.eveses.com 的请求都携带 API 密钥作为 bearer 令牌:

Authorization: Bearer 17|aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcd

密钥在 Account → API Keys 中创建。把它们当作密码——它们提供对余额、激活、租用的完全访问权限。

创建

点击 New key,命名(local-dev、ci、production-eu)。令牌仅在创建时显示一次——立刻保存。

轮换

密钥不可编辑。轮换方式:创建新密钥 → 替换到部署 → 删除旧密钥。删除立即生效。

IP 白名单

每密钥白名单:将密钥绑定到特定的 IP / CIDR 范围。列表外的请求得到 403。在密钥详情页配置。

Scope

所有密钥目前都授予完整账户访问权限。Scope 受限密钥(read-only、rentals-only)在 roadmap 中。

错误

HTTP 含义
401 缺少或畸形的 Authorization
403 密钥被吊销、账户被暂停,或 IP 不在白名单
429 超出每密钥速率限制(默认 60 rpm)