API Key 问题排查

🚀 快速诊断

如果 API 调用返回错误，请按照以下步骤进行排查。

检查服务健康状态

首先确认 API 服务本身是否正常运行。

curl https://api.dev.akria.net/api/v1/health

验证 API Key 是否有效

尝试发送一个简单的测试信号。

curl -X POST https://api.dev.akria.net/api/v1/signals \
  -H "X-API-Key: your-api-key" \
  -d '{"title": "Test", "priority": "low", ...}'

401 Unauthorized - Invalid API Key

可能原因：

解决方法：使用管理脚本 python scripts/manage_api_keys.py list 确认 Key 状态。

401 Unauthorized - Missing API Key

可能原因：

解决方法：确保 Header 格式为 X-API-Key: <your_key>。

API Key has expired

可能原因：

解决方法：联系管理员续期或更换新 Key。

SELECT group_name, SUM(usage_count) FROM api_keys GROUP BY group_name;

-- 查找使用次数异常高的 Key
SELECT id, key_name, usage_count FROM api_keys ORDER BY usage_count DESC LIMIT 10;

详细的日志分析请查看服务器日志：kubectl logs -l app=insight-core-api-dev -n insight-dev