错误码

授权与令牌接口按 RFC 6749 返回错误;资料接口在标准 HTTP 状态码上追加业务错误码。

OAuth 标准错误

error含义排查
invalid_request参数缺失或非法检查必填参数与格式
invalid_clientclient_id / secret 不正确或应用已停用重置密钥或联系平台
invalid_grantcode 过期/已用、redirect_uri 不一致、PKCE 不匹配、refresh 被撤销重新走授权流程
unauthorized_client该客户端不允许使用此 grant检查客户端类型
unsupported_grant_typegrant_type 不支持只支持 authorization_code / refresh_token
invalid_scopescope 非法或超出应用被允许范围在应用详情页申请字段权限
access_denied用户拒绝授权引导用户重新授权

资料接口业务错误

HTTPcode含义
401invalid_tokentoken 无效、过期或已撤销
403insufficient_scope请求的字段不在令牌 scope 内
402insufficient_funds账户余额不足,请充值
404user_not_found用户已注销或不存在
429rate_limited请求过于频繁