应用间带登录态跳转
- 教育号支持应用间带登录态跳转,用户在一个应用完成登录授权后,可以带登录态跳转到另一个应用。
- 第三方应用应该优先根据不同的登录接入方式使用对应的前端授权跳转组件为目标应用获取登录授权code(而不是调用服务端接口)
通过前端组件获取登录授权code
- 网页应用:网页应用带登录态跳转
- H5应用:同网页应用
- 独立小程序:独立小程序带登录态跳转
- 独立APP:独立APP带登录态跳转
通过服务端接口获取登录授权code
使用场景: 从当前应用跳转至目标应用,获取目标应用登录授权code。
权限说明
权限项 | 说明 | 备注 |
---|---|---|
应用是否需要申请白名单 | 是 | 申请方式:联系项目接口人申请 |
用户凭证 | 支持 | |
机构凭证 | 未支持 | - |
请求方式: GET(HTTPS)
请求地址: https://test-oapi.epaas.qq.com/sso/oauth2/get_app_code?access_token=ACCESS_TOKEN
请求参数:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证,使用用户凭证 |
appid | 是 | 要跳转的目标应用id (服务商后台应用详情的SuiteId) |
返回参数:
参数 | 类型 | 说明 |
---|---|---|
errcode | int | 返回码 |
errmsg | string | 对返回码的文本描述内容 |
code | string | 给目标跳转应用下发的code |
请求示例:
https://test-oapi.epaas.qq.com/sso/oauth2/get_app_code?access_token=ACCESS_TOKEN&appid=APPID
返回示例:
{
"errcode": 0,
"errmsg": "ok",
"code": "xxxxxxxxxxxxxx"
}