單點(diǎn)登錄集成

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

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

提醒：請在服務(wù)端發(fā)起接口請求，以保護(hù)賬號信息安全。

請求方式：GET或POST

參數(shù)說明:

參數(shù)名稱

說明

token

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

account

登錄賬號

password

登錄密碼

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

 

redirectURL

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

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

返回值說明：

參數(shù)名稱

說明

userURL

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

adminURL

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

timeOut

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

 

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

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

2、如果當(dāng)前登錄的賬號是管理員也是考生，接口會返回adminURL（后臺）和userURL（前端）兩個地址，開發(fā)者根據(jù)需要，選擇跳轉(zhuǎn)并登錄對應(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"}