Skip to main content

🎯 概述

Core API 支持多组 API Key 管理,可以为不同的团队、项目或环境设置独立的 API Key。

多组支持

为不同团队或环境设置独立 Key,实现精细化权限控制。

使用追踪

实时记录每个 Key 的调用次数和最后使用时间。

动态管理

支持动态添加、禁用或删除 Key,无需重启服务。

📋 获取 API Key

联系管理员

联系 API 管理员获取你所在组的 API Key。

使用管理脚本

如果你有数据库访问权限,可以使用管理脚本在本地创建:
cd services/core-api-v1
python scripts/manage_api_keys.py create \
  --group dev-team-1 \
  --name "Dev Team 1 - Main Key"

🔍 查看与管理

统计查询

# 查看所有 Key 的使用情况
python scripts/manage_api_keys.py list

🔒 安全建议

安全第一:API Key 具有完全访问权限,请务必妥善保管。

存储哈希值

数据库中仅存储 SHA-256 哈希值,即使泄露也无法还原明文。

定期轮换

建议每 3-6 个月更换一次 Key,降低泄露风险。

及时禁用

发现异常使用或成员变动时,应立即禁用对应 Key。

❓ 常见问题

联系管理员查询,或使用管理脚本查看:
python scripts/manage_api_keys.py list
联系管理员创建新的 Key,或使用管理脚本创建。
  1. 立即禁用泄露的 Key
  2. 创建新 Key 并更新应用配置
  3. 确认无误后删除旧 Key