排查 API OAuth 身份验证错误

Last updated: October 9, 2026

针对 500 内部服务器错误以及 Edvisor API 的身份验证问题。

1. 确认 API 端点

仅使用当前端点：https://api-v2.edvisor.io/graphql。

之前的端点 https://api.edvisor.io/graphql 已弃用。旧端点请求可能失败或被阻止。

2. 检查 Authorization 标头

必须严格按照以下格式：Authorization: Bearer <your_edvisor_api_key>。

常见错误：

  • 标头名称拼写错误。
  • 缺少 Bearer 前缀。
  • 存在多余空格。

3. 验证 API 密钥

  • 确认密钥与提供的密钥一致。
  • 检查粘贴过程中是否被意外修改。
  • 如不确定，请联系支持团队重新生成密钥。

4. 设置正确的 Content-Type

必须为：application/json。

Edvisor API 需要此设置才能解析有效负载。

5. 检查是否存在已删除的用户

API 密钥与用户绑定。删除用户会导致相应的 API 密钥失效。请联系支持团队生成新的 API 密钥。

6. 查找拼写错误

仔细检查所有标头和配置字段。一个小小的拼写错误就会导致身份验证失败。

7. 联系支持团队

如果所有步骤都无法解决问题：

附上错误响应或日志。记录所做的更改和收到的错误代码 — 这有助于双方更快解决问题。

请注明涉及的产品或端点（Edvisor 支付、保险等），以便有针对性地解决问题。