通用 OAuth2 授权回调

GET

/oauth/callback

通用 OAuth2/OIDC 驱动的后端回调地址（需在身份提供商处登记为 {站点地址}/api/v2/oauth/callback），由身份提供商在浏览器中重定向访问，前端无需调用。本接口不消费 state，只负责携带 code 与 state 跳转回前端页面，由前端校验 state 后调用「授权登录」或「绑定授权账号」接口。

请求参数

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://127.0.0.1:8000/api/v2/oauth/callback?code=&state=&error=' \
--header 'Accept: application/json'

返回响应

🔵302跳转到前端页面

application/json

不返回 JSON，响应头 Location 为发起授权时记录的前端页面地址（保留原有查询参数），并追加 code、state 查询参数；服务商返回 error 时追加 error；既没有 code 也没有 error 时追加 error=access_denied；state 无效或已过期时跳转到 {前端地址}/login?error=invalid_state。

Bodyapplication/json

示例

{}

修改于 2026-10-23 15:12:15

已绑定的第三方列表

彩虹聚合登录回调