共享 API 密钥
路径:/org/tokens
本页面向:企业所有者与管理员。 普通成员可以看这一页但不能改。个人密钥与企业共享密钥的区别,见密钥与鉴权。
它和成员的个人密钥有什么不同
| 个人密钥 | 企业共享密钥 | |
|---|---|---|
| 扣谁的钱 | 成员自己的账户余额 | 企业的共享余额 |
| 归属 | 某个成员 | 企业本身,不归入任何成员的调用 |
| 个人钱包回落 | 不适用 | 不回落——企业余额不足就是拒绝 |
| 受什么约束 | 成员的额度与订阅 | 密钥自身的额度 |
共享密钥用的是企业余额,不会回落到使用者的个人钱包。 这是它和成员密钥最实质的差别:把共享密钥发给同事,等于把企业余额的使用权交出去。发放前请明确设置密钥额度,并在用量里关注消耗。
创建密钥
创建时要设定额度——这是该密钥能消耗的上限。密钥明文通常只在创建时完整显示一次,请当场保存并交给真正要使用它的人。
密钥状态
| 状态 | 含义 |
|---|---|
| 启用 | 正常可用 |
| 停用 | 被手动关闭,请求会被拒 |
| 过期 | 超过设定的有效期 |
| 用尽 | 已达到该密钥的额度上限 |
启用、停用与删除
- 停用:密钥立即不可用,但记录保留,随时可以重新启用。怀疑泄露时优先用这个——比重建快,也不影响其它密钥。
- 删除:从列表里移除。已经不打算再用的密钥才删除。
谁在用这些密钥
共享密钥的调用不归到某个成员名下,所以在按成员看的用量里不会出现。要核对共享密钥的消耗,看:
待补充:共享密钥维度独立的使用统计(当前控制台没有「按密钥」的用量聚合,只能从请求明细里推断)。