幫助中心 > API

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

該功能接口僅限為尊享版用戶提供


目錄

一、SSO創建和登錄接口

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

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

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

一、SSO創建和登錄接口

接口介紹

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

接口參數說明

請求方式:Get

接口鏈接:www.htjgeq.live/zunxiang/login.aspx?appid=&subuser=&mobile=&email=&roleId=&ts=&sign=

mobile,手機號碼為可選字段,留空時子賬戶的手機號碼為空;

email,郵箱可選字段,留空時子賬戶的郵箱為空;

roleId,子賬戶角色為可選字段,留空時子賬戶的角色默認為“問卷管理員”,可選參數角色對應關系分別為:1-系統管理員,2-問卷管理員,3-統計結果查看員,4-完整結果查看員。

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

創建:第一次使用以上接口時,就是子賬戶的創建過程;

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

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

 

 

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

接口介紹

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

接口參數說明

請求方式:Get

接口鏈接http://www.htjgeq.live/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"},{"qid":"89819","name":"考試","begindate":"2017-08-18 21:21:35","answercount":"4"}]

qid:問卷ID

name:問卷標題

begindata:問卷的創建時間

answercount:當前問卷答卷數
desc:問卷說明(默認不返回),如果需要此字段,請在接口URL參數中增加&includedesc=1。

 

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

接口介紹

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

接口參數說明

請求方式:Get

接口鏈接:http://www.htjgeq.live/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.htjgeq.live/zunxiang/qlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

訪問其他頁面

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

1、待參與頁面:http://www.htjgeq.live/zunxiang/getqlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

2、已參與頁面:http://www.htjgeq.live/zunxiang/getqlistjoin.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

3、答卷詳情頁:http://www.htjgeq.live/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)

非常感謝您的耐心閱讀,請在下方提供您對本篇幫助的反饋,以便我們持續改進本文。
已解決 未解決
長沙冉星信息科技有限公司 版權所有    ICP證:43019002000245    湘ICP備17005436號-1    湘公網安備 43019002000245號   認證聯盟   舉報
網站數據來源于問卷星官方數據庫
pk拾北京赛车平台