GET `/oauth/{provider}/callback`

第三方 OAuth 提供商授权完成后的回调端点。交换授权码获取访问令牌并拉取用户信息。

OAuth None application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`provider`	`path`	`string`	是				提供商名称
`code`	`query`	`string`	是				第三方返回的授权码
`state`	`query`	`string`	是				签名后的 state 参数

响应

状态	描述	Schema
200	回调处理结果（含脱敏 token 和用户信息）	`dto.DataResponse-service-oauth/internal/handler/dto/OAuthCallbackResponse`
400	缺少 code 或 state 无效	`service-core/base/dto.SimpleResponse`
404	不支持的提供商	`service-core/base/dto.SimpleResponse`
500	交换授权码或获取用户信息失败	`service-core/base/dto.SimpleResponse`

引用的 Schema

dto.DataResponse-service-oauth/internal/handler/dto/OAuthCallbackResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-oauth/internal/handler/dto.OAuthCallbackResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-core/base/dto.SimpleResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-oauth/internal/handler/dto.OAuthCallbackResponse

OAuth授权回调结果

字段	类型	必填	示例	约束	描述
`provider`	`string`	否	`github`		提供商
`state`	`string`	否	`state-123`		状态
`token`	`string`	否	`gho_abc1...`		令牌(已脱敏)
`user_info`	`object`	否		extra keys: `string`	用户信息

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓