单点登录¶
注: 所有接口仅针对旗舰会员或以上会员级别提供,非旗舰会员及以上无法调用,所有开放平台接口默认共享10QPS。
单点登录允许考生只在用户的系统上登录一次,点击试卷考试时不再需要再次登录, 例如用户A有公司自己的OA系统, 考生王二登录到公司的OA系统后, 在系统里点开始考试,这时王二就不再需要输入自己的账号,而是直接就进入考试了。
单点登录考试¶
单点登录考试允许用户考生直接在用户系统上点击就开始考试, 不再需要额外的身份认证, 接口如下:
请求
GET https://www.youkaoshi.cn/index.php?option=com_exams&task=api.newStudentSSO&format=raw
请求数据
code=权限码&loginValue=登录字段的值&password=密码&eid=试卷ID
- code 每个账户唯一对应的验证码,string类型,该值可联系优考试获取
- loginValue 表示的是考生的登录值,比如说系统设置了使用手机登录,那么这里就是考生的手机号码。
- password 考生的密码,如果有的话;如果考生没有的话,这里留空
- eid 考生要做的试卷ID
- rflag 如果是登录到考生后台,这里可以指定登录后自动跳转到对应的页面,取考生后台页面连接上的前端路由信息
登录成功后,系统会自动跳转到考试界面,且不需要再执行身份验证
单点登录考生后台¶
单点登录到考生后台和单点登录考试原理一样, 差别是不传eid参数或传0. 即:
GET https://www.youkaoshi.cn/index.php?option=com_exams&task=api.newStudentSSO&format=raw&loginValue=13487361736&password=1294783&eid=0
系统判断eid为0时会自动跳转到考生后台界面
子管理员单点登录¶
子管理员单点登录管理后台, 接口如下:
请求
GET https://www.youkaoshi.cn/index.php?option=com_exams&task=api.childAdminSSO&format=raw
请求数据
code=权限码&email=邮箱&password=密码
- code 每个账户唯一对应的验证码,string类型,该值可联系优考试获取
- email 子管理员邮箱,必填
- password 子管理员密码,必填
登录成功后,系统会自动跳转到管理后台