getOAuthAuthorizeUrl

生成 OAuth 授权 URL 用于 VDS 账户 OAuth 授权流程的第一步

端点:GET /api/proxy/account/sso/authorize 官方文档:vds-docs/VDS 账户/授权端点(Authorize,account.sso.authorize).md

OAuth 流程说明:

  1. 生成授权 URL 并引导用户访问

  2. 用户登录并授权应用

  3. 浏览器重定向到 redirect_uri,附带授权码(code)和状态参数(state)

  4. 使用授权码调用 exchangeOAuthToken() 交换访问令牌

参数说明:

  • client_id: 应用 ID(格式 vap_xxxx)

  • redirect_uri: 授权后重定向 URI(必须是已在开放平台配置的 URI)

  • response_type: 响应类型,固定为 "code"

  • scope: 权限范围(可选),多个权限用空格分隔

  • state: 状态参数(可选),用于防止 CSRF 攻击,回调时会原样返回

  • code_challenge: PKCE code_challenge(可选),用于增强安全性

  • code_challenge_method: PKCE 算法,固定为 "SHA256"

示例:

val params = OAuthAuthorizeParams(
clientId = "vap_xxxxx",
redirectUri = "http://localhost:8080/callback",
state = "random_state_string",
scope = "user.profile",
codeChallenge = codeChallenge,
codeChallengeMethod = "SHA256"
)
val authorizeUrl = authManager.getOAuthAuthorizeUrl(params)
// 打开浏览器访问 authorizeUrl

Return

完整的授权 URL,用户访问此 URL 进行授权

Parameters

params

OAuth 授权参数,包含客户端 ID、重定向 URI 等

See also

参数数据类

initWithOAuth

完整的 OAuth 初始化流程