获取用户授权code - 中望帐号

用户客户端请求用户授权，需要浏览器直接访问。

若用户未登录，将自动跳转至登录页面

若用户已登录，将跳转至回调地址，并以QUERY形式返回结果

返回的授权code在5分钟内有效，使用后失效

若传入provider，表示使用第三方快捷登录，将退出当前登录的用户，使用第三方信息重新登录用户。目前支持的第三方provider：

provider	名称	支持的快捷方式
WeChat	微信	code
WorkWeChat	企业微信	code
QQ	QQ	code、token
Huawei	华为	code、token
Apple	苹果	token
Google	谷歌	code、token
Facebook	脸书	token
GESIC	小微工云	token
LingYang	安徽羚羊云	token
JiaoJianTong	交建通	code

请求参数

Query 参数

client_id

string

客户端ID

必需

scope

string

必需

作用域,，必须有openid

redirect_uri

string

回调地址

必需

response_type

string

必需

返回类型，固定值：code

示例值:

code

state

string

必需

回传声明，随机字符串，请求成功将原样返回

code_challenge

string

必需

PKCE挑战码，创建一个43-128长度字符串（code_verifier，校验码）；对code_verifier进行SHA256并以url-safe的base64编码形式输出，即code_challenge，挑战码

示例值:

cxdCVpA77HBxihlboASY_ysNjX_4a0TMm2UhwBjGnEU

code_challenge_method

string

必需

加密方法，固定值：S256

示例值:

S256

ui_locales

string

可选

界面语言，支持：zh-CN\en-US

theme

string

可选

界面主题，当前仅支持悟空页面的深色(deep)\浅色主题，默认浅色

provider

string

可选

第三方提供商名称，第三方快捷登录\OAuth2登录必须

示例值:

WeChat

token

string

可选

第三方提供商的用户token，用于快捷登录流程

code

string

可选

第三方提供商的用户code，用于OAuth2登录流程

appKey

string

可选

第三方提供商appKey，第三方快捷登录\OAuth2登录必须

failedUrl

string

可选

第三方登录失败时的回调地址，默认登录页面。URL后面将携带query：mes=错误信息

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

text/html

Body

object {0}

示例

请求：
https://accounts.zwsoft.cn/connect/authorize?client_id=TestClient&scope=openid%20profile%20email%20phone%20offline_access%20ZMS.UserDetails.Read&redirect_uri=https://web.zwsoft.cn/login/callback/&response_type=code&state=RandomString&code_challenge=cxdCVpA77HBxihlboASY_ysNjX_4a0TMm2UhwBjGnEU&code_challenge_method=S256

回调：
https://web.zwsoft.cn/login/callback/?code=IHTlN-SenobUzAlHOx8JMEPN6i_nEpzEtV6XcWzp70U&scope=profile%20email%20phone%20offline_access%20ZMS.UserDetails.Read%20openid&tate=RandomString&session_state=zgjAl5K3sVNQDquK4NvRurqr9woI4lJTBYriQyiPauY.zAmrhoCfcYOe8TuljqE71g