单点登录集成

实现与第三方应用系统或App进行单点登录集成,实现考生或管理员登录考试云考生中心或管理后台。

接口地址:https://api.kaoshiyun.com.cn/api/v5/singlein.ashx?token=[Token]&account=[Account]&password=[Password]

提醒:请在服务端发起接口请求,以保护账号信息安全。

请求方式:GET或POST

参数说明:

参数名称

说明

token

接口调用凭证,2小时内有效,请注意时效性

account

登录账号

password

登录密码

注意:如果第三方系统无法传递密码,可以采用免密登录。只需要传递Token和account参数即可。

 

返回值说明:

参数名称

说明

userURL

登录到考试云考生端地址,直接跳转可登录考生端中心

adminURL

登录到考试云管理端地址,直接跳转可登录后台管理

timeOut

120秒过期,指当前获取的userURLadminURL登录链接的有效时间,单位()

 

1、如果当前登录的账号是考生,接口会返回登录到考生中心的userURL,直接执行跳转到userURL可登录到考生端中心

{"timeOut":"120(s)","userURL":"https://考生端地址?key=b1FN8BRFZRUdMnq4M7biSsld3bsXjFNtwYiAurd5SlyuwfbKNmy"}

2、如果当前登录的账号是管理员也是考生,接口会返回adminURL(后台)和userURL(前端)两个地址,开发者根据需要,选择跳转并登录对应的地址。

{"timeOut":"120(s)","adminURL":"https://管理端地址?key=dsfDSQ0IOEKDOEJowwefdOIEUWLKDEWJND3209kddsfpopdxli","userURL":"https://考生端地址?key=dsaldfsakfdweieeiwIEODWO332390SDF"}

返回失败示例:

{"errcode":"40006","errmsg":"AccessToken has expired"}
{"errcode":"40004","errmsg":"login fail, reason:account or password is incorrect"}