🔐 身份验证

🔑 API密钥

所有API请求都需要进行身份验证。我们使用API密钥来识别和验证您的应用。

获取API密钥
  1. 登录到您的ANEVOL账户
  2. 进入API密钥管理页面
  3. 点击"创建新密钥"按钮
  4. 为您的密钥设置描述性名称
  5. 复制生成的API密钥并安全保存
重要提醒:请妥善保管您的API密钥,不要在客户端代码或公共代码库中暴露密钥。

📤 请求头验证

在每个API请求中,您需要在请求头中包含以下字段:

请求头参数
参数名 必填 说明
Authorization API密钥,格式为:Bearer YOUR_API_KEY
Content-Type 请求体格式,固定为:application/json
示例
POST /v1/search HTTP/1.1
Host: tiku.anevol.cn
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

🚫 错误响应

如果API密钥无效或缺失,您将收到以下错误响应:

错误码说明
错误码 说明 解决方案
401 未提供API密钥 在请求头中添加有效的Authorization字段
403 API密钥无效 检查API密钥是否正确,或重新生成新的密钥
错误响应示例
{
  "code": 401,
  "message": "Unauthorized: API key is missing",
  "data": null
}