三方系统唤起客户端上课方案说明

一、功能说明

为方便外部网页系统快速唤起伯索/爱问客户端进入课堂，平台提供标准客户端唤起 URL。

外部系统可通过该 URL 实现以下能力：

自动判断用户本机是否已安装客户端；

未安装客户端时，引导用户跳转至机构客户端下载页；

已安装客户端时，自动唤起客户端；

支持通过用户名和课堂 ID 快速定位课堂；

支持用户自动登录或跳转登录页后进入课堂。

二、适用场景

该能力适用于以下场景：

机构自有网页系统中提供“快捷上课”入口；

第三方系统中嵌入伯索/爱问课堂入口；

机构希望通过外部页面一键唤起客户端进入指定课堂；

需要通过 Open API 对接课堂跳转能力。

三、URL 参数说明

获取唤起客户端链接URL：https://app.apifox.com/link/project/3466838/apis/api-466296764

标准唤起 URL 需携带以下核心参数：

参数	说明	是否必填
用户名	伯索/爱问平台中的学生账号用户名	是
课堂 ID	需要进入的目标课堂 ID	是

系统会根据 URL 中传入的用户名和课堂 ID，自动完成客户端唤起、账号识别和课堂权限校验。

四、客户端安装判断逻辑

当用户点击标准唤起 URL 后，系统会先判断当前设备是否已安装伯索/爱问客户端。

1. 未安装客户端

如果检测到用户本机未安装客户端，系统将自动跳转至机构客户端下载页。

用户需先下载并安装客户端，安装完成后再进入课堂。

2. 已安装客户端

如果检测到用户本机已安装客户端，系统将自动唤起客户端，并继续执行后续登录和课堂进入流程。

五、用户登录处理逻辑

客户端唤起后，系统会根据 URL 中传入的用户名，判断该用户名是否存在于本机已记住的账号中。

1. 用户名存在于本机已记住账号中

如果该用户名已存在于本机账号列表中，系统将自动使用该账号登录客户端。

登录成功后，继续根据课堂 ID 校验课堂权限。

2. 用户名不存在于本机已记住账号中

如果该用户名不在本机已记住账号中，系统将跳转至登录页，并自动填入 URL 中传入的用户名。

用户完成登录后，系统继续根据课堂 ID 校验课堂权限。

六、课堂进入与权限校验逻辑

用户登录成功后，系统会根据 URL 中传入的课堂 ID 校验当前用户是否具备该课堂的进入权限。

1. 用户具备课堂权限

如果当前用户在该课堂的学生课表中，系统将自动加入并进入课堂。

2. 用户不具备课堂权限

如果用户不在该课堂的学生课表中，或加入课堂失败，系统将返回实时课堂列表页。

用户可在实时课堂列表中查看当前账号可进入的课堂。

三方系统唤起客户端上课方案说明

一、功能说明#

二、适用场景#

三、URL 参数说明#

四、客户端安装判断逻辑#

1. 未安装客户端#

2. 已安装客户端#

五、用户登录处理逻辑#

1. 用户名存在于本机已记住账号中#

2. 用户名不存在于本机已记住账号中#

六、课堂进入与权限校验逻辑#

1. 用户具备课堂权限#

2. 用户不具备课堂权限#

七、完整跳转流程#