获取三方登录的回调地址

GET 
/auth/v1/provider/uri

接口说明

获取第三方身份源登录的回调地址，用于OAuth授权流程

入参要求：

• provider_id: 身份源id（必填，如：github、wechat等）
• redirect_uri: 重定向地址（可选）
• state: 客户端状态参数（可选，用于防止CSRF攻击）
• scope: 授权范围（可选）
• response_type: 授权类型（可选）
• client_id: 客户端id（可选，默认为环境id）
• x-device-id: 设备id（必填，请求头中传入）

出参：

• 返回第三方登录的回调地址URI

请求示例：

GET /auth/v1/provider/uri?provider_id=github&state=random_state_string
x-device-id: device_123456

响应示例：

{
  "uri": "https://github.com/login/oauth/authorize?client_id=your_client_id&redirect_uri=https://your-app.com/callback&state=random_state_string&scope=user"
}

使用流程：

1. 调用此接口获取第三方登录地址
2. 将用户重定向到返回的URI
3. 用户完成第三方授权后，回调到指定的redirect_uri
4. 在回调中获取授权码，用于后续token获取

Request

Query Parameters

provider_id stringrequired
身份源id
Example: github
redirect_uri string

重定向地址

state string

客户端的当前状态，可以指定任意值

scope string

授权范围

response_type string

授权类型

client_id string

应用对应的客户端id，默认为环境id，可以不传

Header Parameters

x-device-id stringrequired

设备id

Responses

200

A successful response.

Response Headers

application/json

Schema

Schema

uri 回调url (string)

Example (from schema)

{
  "uri": "string"
}

500

An unexpected error response.

Response Headers

application/json

Schema

Schema

error 错误信息 (string)
error_code int32
error_description 错误描述 (string)

Example (from schema)

{
  "error": "string",
  "error_code": 0,
  "error_description": "string"
}

Loading...