單點(diǎn)登錄(SSO)子賬戶接口

該功能接口僅限為旗艦版用戶提供

目錄

一、SSO創(chuàng)建和登錄接口

二、獲取SSO子賬戶問(wèn)卷列表接口

三、獲取SSO子賬戶答卷數(shù)據(jù)接口

四、SSO子賬戶參與者端接口

一、SSO創(chuàng)建和登錄接口

接口介紹

使用該接口，可以通過(guò)單點(diǎn)登錄（SSO）的方式創(chuàng)建子賬戶，創(chuàng)建成功之后可以通過(guò)此接口登錄子賬戶。使用此接口創(chuàng)建的用戶，屬于主賬戶下屬的子賬戶，權(quán)益同主賬戶同步。除創(chuàng)建和登錄方式不同外，其他權(quán)益、設(shè)置同手動(dòng)創(chuàng)建的子賬戶完全一致。

接口參數(shù)說(shuō)明

請(qǐng)求方式：Get

接口鏈接：http://cgior.cn/zunxiang/login.aspx?appid=&subuser=&mobile=&email=&roleId=&ts=&sign=

子賬戶的創(chuàng)建/登錄和刪除

創(chuàng)建：第一次使用以上接口時(shí)，就是子賬戶的創(chuàng)建過(guò)程；

登錄：子賬戶登錄和創(chuàng)建使用相同的接口，其中手機(jī)號(hào)碼、郵箱、角色三個(gè)字段，僅在首次創(chuàng)建時(shí)有效，在第二次登錄時(shí)如果三個(gè)字段信息有更改，也不會(huì)將傳遞信息更新到問(wèn)卷星系統(tǒng)；

刪除：如需刪除子賬戶，需要主賬戶登錄后，在多用戶管理頁(yè)面手動(dòng)刪除。需要注意是：在您自己系統(tǒng)刪除一個(gè)員工賬戶后，無(wú)法自動(dòng)同步刪除其在問(wèn)卷星對(duì)應(yīng)的子賬戶。

二、獲取SSO子賬戶問(wèn)卷列表接口

接口介紹

通過(guò)此接口，可以獲取某一個(gè)子賬戶問(wèn)卷管理員名下的問(wèn)卷列表。

接口參數(shù)說(shuō)明

請(qǐng)求方式：Get

接口鏈接：http://cgior.cn/zunxiang/getuserq.aspx?appid=&username=&ts=&folder=&sign=

獲取到數(shù)據(jù)說(shuō)明

此接口會(huì)有10分鐘的緩存時(shí)間，新增的問(wèn)卷可能需要10分鐘以后才能獲取。如果需要實(shí)時(shí)獲取，請(qǐng)?jiān)诮涌赨RL參數(shù)中增加&nocache=1（增加參數(shù)后，接口每分鐘只能調(diào)用5次）。

數(shù)據(jù)格式：JSON

數(shù)據(jù)示例： [{"qid":"89767","name":"新考試","begindate":"2017-08-20 11:52:43","answercount":"5","pcurl":"http://cgior.cn/jq/89767.aspx","murl":"http://cgior.cn/m/89767.aspx"},{"qid":"89819","name":"考試","begindate":"2017-08-18 21:21:35","answercount":"4","pcurl":"http://cgior.cn/jq/89819.aspx","murl":"http://cgior.cn/m/89819.aspx"}]

qid：?jiǎn)柧鞩D

name：?jiǎn)柧順?biāo)題

begindata：?jiǎn)柧淼膭?chuàng)建時(shí)間

answercount：當(dāng)前問(wèn)卷答卷數(shù)
desc:問(wèn)卷說(shuō)明（默認(rèn)不返回），如果需要此字段，請(qǐng)?jiān)诮涌赨RL參數(shù)中增加&includedesc=1。
pcurl: PC端問(wèn)卷訪問(wèn)鏈接
murl: 移動(dòng)端問(wèn)卷訪問(wèn)鏈接

三、獲取SSO子賬戶答卷數(shù)據(jù)接口

接口介紹

通過(guò)此接口可以獲取到部分答卷數(shù)據(jù)，包括：提交序號(hào)、參與者姓名、總分、提交時(shí)間、提交所用時(shí)間。需要注意的是，只有答卷總數(shù)少于20000才能使用此接口，而且此接口只能獲取到部分?jǐn)?shù)據(jù)而且全部答卷詳情數(shù)據(jù)。如需獲取全部答卷詳情數(shù)據(jù)，可以參考：數(shù)據(jù)推送的API接口。

接口參數(shù)說(shuō)明

請(qǐng)求方式：Get

接口鏈接：http://cgior.cn/zunxiang/getjoinlist.aspx?appid=&activity=&ts=&sign=&pageindex=&pagesize=

獲取到數(shù)據(jù)說(shuō)明

數(shù)據(jù)格式：JSON

數(shù)據(jù)示例：

[{"parterjoiner":"test2","totalvalue":"15","index":"3","timetaken":"8","submittime":"2017-08-20 14:25:39"},{"parterjoiner":"test3","totalvalue":"15","index":"4","timetaken":"141","submittime":"2017-08-20 14:38:55"}]

parterjoiner：參與者姓名

totalvalue：當(dāng)前答卷得分

index：當(dāng)前答卷序號(hào)

timetaken：當(dāng)前答卷作答所用的時(shí)間，單位：秒

submittime：當(dāng)前答卷的提示時(shí)間

四、SSO子賬戶參與者端接口

接口介紹

使用該接口，做為問(wèn)卷或考試填寫(xiě)參與者的登錄之后，可看到一個(gè)完善的填寫(xiě)參與者的用戶體系，查看到自己需要作答哪些問(wèn)卷、已經(jīng)完成了哪些問(wèn)卷、積分排行等等信息。

接口參數(shù)說(shuō)明

請(qǐng)求方式：get

加密鏈接參數(shù)如下：http://cgior.cn/zunxiang/qlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

訪問(wèn)其他頁(yè)面

以上接口填寫(xiě)者參與者點(diǎn)擊后訪問(wèn)的是用戶體系的主頁(yè)，還可以通過(guò)攜帶參數(shù)訪問(wèn)其他不同的頁(yè)面，如：

1、待參與頁(yè)面：http://cgior.cn/zunxiang/qlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

2、已參與頁(yè)面：http://cgior.cn/zunxiang/qlistjoin.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

3、答卷詳情頁(yè)：http://cgior.cn/zunxiang/joinrelquery.aspx?appid=&username=&joiner=&activity=&joinid=&realname=&dept=&extf=&ts=&sign=，如果需要隱藏返回按鈕，請(qǐng)?jiān)趨?shù)后面加上&noback=1。

訪問(wèn)答卷詳情頁(yè)，需增加兩個(gè)參數(shù)：activity（問(wèn)卷ID）和joinid（答卷流水號(hào)，需使用數(shù)據(jù)推送接口獲?。瑫r(shí)加密簽名算法改變?yōu)椋簊ign=sha1(appid+appkey+username+joiner+activity+joinid+realname+dept+extf+ts)