Skip to main content

故障排除（集成方）

授权与鉴权​

invalid_client / unauthorized_client​

  • 检查 client_id / client_secret 是否正确
  • 确认该应用未被禁用
  • 确认 redirect_uri 与注册时完全一致（包括协议、端口、路径）

回调拿不到 code​

  • 确认授权请求里 response_type=code
  • 确认用户确实点击了“同意授权”
  • 检查浏览器/代理是否改写了 redirect_uri

401：已带 Authorization 仍未授权​

  • 确认使用 Authorization: Bearer <access_token>
  • 确认 token 未过期；必要时使用 refresh token
  • 确认 token 的 scope 覆盖目标 API 所需权限

API 调用​

400：参数校验失败​

  • 对照 API 文档检查字段名、类型与枚举值
  • 记录服务端返回的错误信息，便于排查与提 issue

429：请求过于频繁​

  • 降低并发并做指数退避重试
  • 同步任务建议队列化并做节流

需要进一步帮助？​

  • Issues：https://github.com/eslsoft/vocnet/issues
  • Discussions：https://github.com/eslsoft/vocnet/discussions