单点登录集成

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

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

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

请求方式：GET或POST

参数说明:

参数名称

说明

token

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

account

登录账号

password

登录密码

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

 

redirectURL

【选填参数】用于登录成功后，跳转到指定链接。

例如：登录成功后想跳转至某个指定的考试、练习、课程时，可通过此参数传相应链接实现跳转。

返回值说明：

参数名称

说明

userURL

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

adminURL

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

timeOut

120秒过期，指当前获取的userURL或adminURL登录链接的有效时间，单位(秒)

 

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"}