New API开放平台

OAuth2 统一登录

authorization_code 模式的统一登录和统一退出流程。

开放平台使用 OAuth2 authorization_code 模式。secret 与用户 access_token 应保存在服务端,不应暴露在客户端。

1. 请求授权码

跳转至 /sso,携带 appid、经过 URI 编码的 redirect_uri 和 state。用户授权后,平台重定向至:

redirect_uri?code=CODE&state=STATE

授权码只能使用一次。

2. 换取令牌

调用 API1022 或 API1101,以 code、appid、secret、redirect_uri 和 state 换取 access_token、refresh_token、openid 与 unionid。V2 接口可以提交 logout_notify_url 并获得 session_token。

3. 获取用户信息

调用 API1023,使用 access_token、openid 与 appid 获取用户基础信息。企业用户返回 enterpriseInfo,个人用户返回 personInfo。

统一退出

接入方需要自行实现退出回调,并保存平台 sessionToken 与本地会话的对应关系。回调请求体包含必填的 sessionToken: String(128)。源文档没有给出该回调的固定路径、接口编码及响应结构,因此未生成 OpenAPI 操作。

这篇文档对您有帮助吗?