🔑
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) |