---
title: 认证
description: 安全使用专用 Bearer API Key。
sidebar:
  order: 3
---

每次请求都必须在 `Authorization` 请求头中提供专用 Key：

```http
Authorization: Bearer YOUR_API_KEY
```

接口不接受 query-string Key。Dashboard 会话 Cookie 不能替代此 Key，此 Key 也不能访问现有 `/bi/*` 接口。

## Key 安全

- 将 Key 保存到密码管理器、Secret Manager 或受保护的环境变量。
- 不要把 Key 提交到 Git、日志、截图或支持消息中。
- 在共享电脑上不要勾选 Playground 的 **Remember on this device**。该选项会把 Key 存入本文档域名的 `localStorage`，直到被清除。
- 如果怀疑泄露，请联系 Mellow 对接人轮换 Key。

:::warning
v1 使用一个共享 Key。轮换后，所有调用方的旧 Key 会同时失效。
:::