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

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

目錄

一、SSO創建和登錄接口

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

三、獲取SSO子賬戶答卷數據接口

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

一、SSO創建和登錄接口

接口介紹

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

接口參數說明

請求方式：Get

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

子賬戶的創建/登錄和刪除

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

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

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

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

接口介紹

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

接口參數說明

請求方式：Get

接口鏈接：http://www.kaben.cc/zunxiang/getuserq.aspx?appid=&username=&ts=&folder=&sign=

獲取到數據說明

此接口會有10分鐘的緩存時間，新增的問卷可能需要10分鐘以后才能獲取。如果需要實時獲取，請在接口URL參數中增加&nocache=1（增加參數后，接口每分鐘只能調用5次）。

數據格式：JSON

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

qid：問卷ID

name：問卷標題

begindata：問卷的創建時間

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

三、獲取SSO子賬戶答卷數據接口

接口介紹

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

接口參數說明

請求方式：Get

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

獲取到數據說明

數據格式：JSON

數據示例：

[{"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：當前答卷得分

index：當前答卷序號

timetaken：當前答卷作答所用的時間，單位：秒

submittime：當前答卷的提示時間

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

接口介紹

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

接口參數說明

請求方式：get

加密鏈接參數如下：http://www.kaben.cc/zunxiang/qlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

訪問其他頁面

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

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

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

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

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