POST/api/auth/sso/exchange

SSO 登录(SAML/OIDC)的最后一步:将重定向中的一次性代码交换为访问令牌和刷新令牌。

在身份提供商处完成登录后,Zentor App 会将浏览器重定向回来,并在查询参数 `sso_code` 中附带一次性代码。请将此代码通过 `code` 字段发送。响应包含 `token` 和 `refreshToken`,与常规登录相同。 每个代码仅在短时间内有效一次。已被使用、已过期或无效的代码会返回 400 `SSO_EXCHANGE_INVALID`;此时用户需要重新开始 SSO 登录。因此,此调用不是幂等的。

概览

调用:POST /api/auth/sso/exchange。该端点属于 Zentor App API 的“身份验证”分组。 该端点可公开访问,无需身份验证。 该调用不是幂等的:每次成功调用都会再次触发该操作。 必填参数:code (请求体)。 已记录的错误情况:400 SSO_EXCHANGE_INVALID。 下方的示例响应展示了 JSON 格式的成功响应结构。

身份验证与安全

无需身份验证

幂等: 否

参数

code(body, string,必填)— SSO 重定向返回的一次性代码

请求示例

{"code":"<来自 SSO 回调重定向的一次性代码>"}

响应示例

{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}

错误代码

400 SSO_EXCHANGE_INVALID — 代码无效、已被使用或已过期。

已验证的行为

无效代码返回 400 `SSO_EXCHANGE_INVALID`。成功情况需要在已配置的身份提供商处完成完整登录。

身份验证

相关文章

← 身份验证