管理开放平台身份凭证,了解 API 与 MCP 的认证方式。
| 接入方式 | 认证方式 | 使用方法 |
|---|---|---|
| MCP | OAuth 账号授权 | 在客户端连接服务并完成爱给账号授权,由客户端管理访问令牌 |
| API | API Key | 在 Authorization 请求头中填写 Bearer 加空格,再填写 API Key |
两种方式均关联您的爱给账号,但 API Key 与 OAuth 访问令牌不可互换。
已有密钥可随时查看和复制。数量达到上限时,请删除不再使用的密钥。
在请求头中添加 Authorization,将以下占位内容替换为您的 API Key。Bearer 与密钥之间保留一个空格。
Authorization: Bearer your_api_key_here
使用 HTTPS 发起请求,不要将密钥放入 URL。
更换密钥时,先创建新密钥并更新应用配置,确认调用正常后再禁用或删除旧密钥。
API Key 长期有效,建议定期更换。请保存在服务端,不要暴露在前端代码、公开仓库、日志或截图中。
如怀疑泄露,请及时禁用或删除该密钥,检查调用日志并更换新密钥。
接口返回 HTTP 401 时,请根据错误码排查:
| 错误码 | 说明 | 处理方式 |
|---|---|---|
50102 |
缺少认证信息 | 添加 Authorization 请求头。 |
50103 |
认证格式错误 | 检查 Bearer 前缀、空格及密钥是否填写完整。 |
50101 |
密钥无效 | 检查密钥是否正确、已启用且未删除。 |