密钥与认证
创建密钥
客户端「个人中心 → API 接入」里创建。密钥分两种：
| 类型 | 有效期 | 适用 |
|---|---|---|
| 跟随账号 | 随登录状态生效与失效 | 自己在桌面端或本机工具里用 |
| 长期密钥 | 一年，可单独撤销 | 服务器、CI、第三方客户端 |
长期密钥的完整明文只在创建时显示一次。
怎么带密钥
每个请求加一个请求头：
Authorization: Bearer <你的密钥>
网关会怎么处理你的请求头
网关会重建发往上游的请求头，只带我们自己的渠道凭证。你额外加的请求头不会透传到上游，所以不需要也不应该在这里做任何上游鉴权配置。
安全建议
- 不要把密钥写进前端代码、日志或截图
- 一把密钥只在一个环境用；泄露就立刻撤销重建
- 服务端调用优先用长期密钥，方便单独失效
401 怎么处理
返回 401 表示密钥缺失、无效、已撤销或已过期。先确认请求头拼写和密钥是否被截断，再确认这把密钥在客户端里仍然有效。