TokenFlow

API Key 与认证

所有请求都用一个 HTTP Header 鉴权,没有签名、没有时间戳、没有额外参数。

Key 的生命周期

  • 创建:控制台「API 密钥」→ 新建。名称自己取,用于区分用途(比如「线上」「测试」)。
  • 可见性:完整 Key 只在创建时完整显示一次,之后列表里是打码的。丢了就重建,找不回来。
  • 限额:单个 Key 可以设额度上限和过期时间。给客户端用的 Key 建议设上限,避免一把钥匙刷穿账户。
  • 停用:在列表里切到「已禁用」,即时生效;删除则不可恢复。

安全建议

  • 不要把 Key 写进前端代码或提交到 Git 仓库——它等同于你的账户余额。
  • 服务端调用时从环境变量读,别硬编码。
  • 一把 Key 只给一个用途,出问题时能单独停用,不影响其他业务。
  • 怀疑泄露就立刻在控制台删除该 Key,重新生成一把。

返回 401 时怎么排查,见错误码页。