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

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

目錄

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

二、獲取SSO子賬戶問卷列表接口

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

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

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

接口介紹

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

接口參數(shù)說明

請求方式：Get

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

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

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

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

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

二、獲取SSO子賬戶問卷列表接口

接口介紹

通過此接口，可以獲取某一個子賬戶問卷管理員名下的問卷列表。

接口參數(shù)說明

請求方式：Get

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

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

此接口會有10分鐘的緩存時間，新增的問卷可能需要10分鐘以后才能獲取。如果需要實時獲取，請在接口URL參數(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：問卷ID

name：問卷標(biāo)題

begindata：問卷的創(chuàng)建時間

answercount：當(dāng)前問卷答卷數(shù)
desc:問卷說明（默認(rèn)不返回），如果需要此字段，請在接口URL參數(shù)中增加&includedesc=1。
pcurl: PC端問卷訪問鏈接
murl: 移動端問卷訪問鏈接

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

接口介紹

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

接口參數(shù)說明

請求方式：Get

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

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

數(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)前答卷序號

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

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

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

接口介紹

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

接口參數(shù)說明

請求方式：get

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

訪問其他頁面

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

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

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

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

訪問答卷詳情頁，需增加兩個參數(shù)：activity（問卷ID）和joinid（答卷流水號，需使用數(shù)據(jù)推送接口獲取），同時加密簽名算法改變?yōu)椋簊ign=sha1(appid+appkey+username+joiner+activity+joinid+realname+dept+extf+ts)