> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akria.net/llms.txt
> Use this file to discover all available pages before exploring further.

# API Key 问题排查

> API Key 相关常见问题诊断与解决

## 🚀 快速诊断

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

<Steps>
  <Step title="检查服务健康状态" icon="heart-pulse">
    首先确认 API 服务本身是否正常运行。

    ```bash theme={null}
    curl https://api.dev.akria.net/api/v1/health
    ```
  </Step>

  <Step title="验证 API Key 是否有效" icon="key">
    尝试发送一个简单的测试信号。

    ```bash theme={null}
    curl -X POST https://api.dev.akria.net/api/v1/signals \
      -H "X-API-Key: your-api-key" \
      -d '{"title": "Test", "priority": "low", ...}'
    ```
  </Step>
</Steps>

***

## 🔍 常见错误排查

<AccordionGroup>
  <Accordion title="401 Unauthorized - Invalid API Key">
    **可能原因**：

    * Key 填写错误（检查是否有空格）
    * Key 已被禁用或删除
    * 数据库哈希值不匹配

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

  <Accordion title="401 Unauthorized - Missing API Key">
    **可能原因**：

    * 未在 Header 中包含 `X-API-Key`
    * Header 名称拼写错误

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

  <Accordion title="API Key has expired">
    **可能原因**：

    * Key 已超过设定的过期时间

    **解决方法**：联系管理员续期或更换新 Key。
  </Accordion>
</AccordionGroup>

***

## 📊 使用统计查看

<Tabs>
  <Tab title="按组统计">
    ```sql theme={null}
    SELECT group_name, SUM(usage_count) FROM api_keys GROUP BY group_name;
    ```
  </Tab>

  <Tab title="异常监控">
    ```sql theme={null}
    -- 查找使用次数异常高的 Key
    SELECT id, key_name, usage_count FROM api_keys ORDER BY usage_count DESC LIMIT 10;
    ```
  </Tab>
</Tabs>

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