错误码
授权与令牌接口按 RFC 6749 返回错误;资料接口在标准 HTTP 状态码上追加业务错误码。
OAuth 标准错误
| error | 含义 | 排查 |
invalid_request | 参数缺失或非法 | 检查必填参数与格式 |
invalid_client | client_id / secret 不正确或应用已停用 | 重置密钥或联系平台 |
invalid_grant | code 过期/已用、redirect_uri 不一致、PKCE 不匹配、refresh 被撤销 | 重新走授权流程 |
unauthorized_client | 该客户端不允许使用此 grant | 检查客户端类型 |
unsupported_grant_type | grant_type 不支持 | 只支持 authorization_code / refresh_token |
invalid_scope | scope 非法或超出应用被允许范围 | 在应用详情页申请字段权限 |
access_denied | 用户拒绝授权 | 引导用户重新授权 |
资料接口业务错误
| HTTP | code | 含义 |
| 401 | invalid_token | token 无效、过期或已撤销 |
| 403 | insufficient_scope | 请求的字段不在令牌 scope 内 |
| 402 | insufficient_funds | 账户余额不足,请充值 |
| 404 | user_not_found | 用户已注销或不存在 |
| 429 | rate_limited | 请求过于频繁 |