了解如何对您的 API 请求进行认证
⚠️ 保护您的 API Key 安全 切勿将 API Key 提交到版本控制系统 不要公开分享您的 API Key 使用环境变量存储密钥 定期轮换密钥以增强安全性
Authorization 请求头中包含您的 API Key,并添加 Bearer 前缀:$env:SURGEAI_API_KEY="your-api-key-here".env 文件:⚠️ 始终将 .env添加到.gitignore文件中,以防止意外提交密钥。
{
"error": {
"message": "Invalid authentication credentials",
"type": "invalid_request_error",
"code": "invalid_api_key"
}
}{
"error": {
"message": "You do not have access to this resource",
"type": "permission_error",
"code": "insufficient_permissions"
}
}{
"error": {
"message": "Rate limit exceeded",
"type": "rate_limit_error",
"code": "rate_limit_exceeded"
}
}| 实践 | 说明 |
|---|---|
| 使用环境变量 | 始终将 API Key 存储在环境变量中,绝不要放在源代码中 |
| 实施密钥轮换 | 定期轮换 API Key 以最小化安全风险。在撤销旧密钥之前生成新密钥并更新应用程序 |
| 不同环境使用不同密钥 | 为开发、测试和生产环境使用单独的 API Key |
| 监控使用情况 | 定期在控制台检查 API 使用情况,以检测任何异常活动 |
| 实施速率限制 | 实施客户端速率限制,避免触发 API 速率限制 |
💡 设置密钥过期策略,以在指定时间后自动轮换密钥。