创建
1
进入管理 Key 页面
登录 控制台,在侧边栏选择 构建与使用 → 管理 Key。
2
填写名称并选择作用域
起一个能认出用途的名字,例如「对账脚本」。然后只勾选这个脚本真正需要的作用域,默认勾选的三项都是只读的。作用域清单见作用域。
3
选择有效期
可选 7 天、30 天、90 天、365 天、自定义天数或永不过期。
4
立即保存明文
创建成功后完整内容只显示这一次。关闭对话框之后无法再次查看,系统只保存它的哈希值。
认证方式
把 Admin Key 放进Authorization 请求头:
success 为 false 时,message 里是可读的失败原因,部分错误还带 code 字段。
能力边界
Admin Key 能做什么完全由你勾选的作用域决定。除此之外还有三条无论勾选什么都不可逾越的边界:碰不到管理后台
管理端、代理商端、供应商端的全部接口一律拒绝,与账号角色无关。管理员账号的 Admin Key 同样只能做用户端的事。
改不了账号安全
改密码、删除账号、双因素、Passkey、手机与邮箱绑定、实名认证,全部拒绝。
动不了钱和密钥明文
充值、提现、支付方式、发票提交一律拒绝;已有 API 密钥的明文也永远取不到。
生命周期
- 数量上限:同一账号最多同时存在 10 枚有效的 Admin Key,每天最多创建 5 枚。
- 可以编辑:创建之后可以修改名称和作用域。有效期不可修改 —— 需要换期限请重新创建一枚。
- 随时撤销:可以单独撤销某一枚,也可以一次撤销全部。撤销立即生效,不可恢复。
- 改密码即全部失效:修改账号密码会让名下全部 Admin Key 立即失效,包括选了永不过期的那些。
怀疑泄露了怎么办
1
立即撤销
到管理 Key 页面点「撤销全部」。这个动作同时会把你在其他设备上的登录一并登出。
2
检查审计日志
在 构建与使用 → 审计日志 里查看这枚 Key 的使用记录,包括首次使用时间和来源 IP。
3
重新创建
用更小的作用域和更短的有效期重新创建,只勾脚本真正用得到的那几项。
系统会在一枚 Key 频繁触碰能力边界时自动记录审计。持续被拒通常意味着两件事之一:脚本配错了作用域,或者这枚 Key 落到了不知道它边界的人手里。