單點(diǎn)登錄集成

實(shí)現(xiàn)與第三方應(yīng)用系統(tǒng)或App進(jìn)行單點(diǎn)登錄集成，實(shí)現(xiàn)考生或管理員登錄考試云考生中心或管理后臺(tái)。

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

提醒：請(qǐng)?jiān)诜?wù)端發(fā)起接口請(qǐng)求，以保護(hù)賬號(hào)信息安全。

請(qǐng)求方式：GET或POST

參數(shù)說(shuō)明:

參數(shù)名稱

說(shuō)明

token

接口調(diào)用憑證，2小時(shí)內(nèi)有效，請(qǐng)注意時(shí)效性

account

登錄賬號(hào)

password

登錄密碼

注意：如果第三方系統(tǒng)無(wú)法傳遞密碼，可以采用免密登錄。只需要傳遞Token和account參數(shù)即可。

 

redirectURL

【選填參數(shù)】用于登錄成功后，跳轉(zhuǎn)到指定鏈接。

例如：登錄成功后想跳轉(zhuǎn)至某個(gè)指定的考試、練習(xí)、課程時(shí)，可通過此參數(shù)傳相應(yīng)鏈接實(shí)現(xiàn)跳轉(zhuǎn)。

返回值說(shuō)明：

參數(shù)名稱

說(shuō)明

userURL

登錄到考試云考生端地址，直接跳轉(zhuǎn)可登錄考生端中心

adminURL

登錄到考試云管理端地址，直接跳轉(zhuǎn)可登錄后臺(tái)管理

timeOut

120秒過期，指當(dāng)前獲取的userURL或adminURL登錄鏈接的有效時(shí)間，單位(秒)

 

1、如果當(dāng)前登錄的賬號(hào)是考生，接口會(huì)返回登錄到考生中心的userURL，直接執(zhí)行跳轉(zhuǎn)到userURL可登錄到考生端中心

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

2、如果當(dāng)前登錄的賬號(hào)是管理員也是考生，接口會(huì)返回adminURL（后臺(tái)）和userURL（前端）兩個(gè)地址，開發(fā)者根據(jù)需要，選擇跳轉(zhuǎn)并登錄對(duì)應(yīng)的地址。

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