幫助中心 > API

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

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


目錄

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

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

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

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

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

接口介紹

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

接口參數(shù)說明

請(qǐng)求方式:Get

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


參數(shù)名 參數(shù)說明 是否必須
appid 開發(fā)ID,需聯(lián)系客服生成,生成后可以在多用戶管理頁面查看
appkey 開發(fā)秘鑰,需聯(lián)系客服生成,生成后可以在多用戶管理頁面查看
ts 時(shí)間戳,從1970-01-01 00:00:00開始到現(xiàn)在的秒數(shù),有效期為60秒
encode 簽名驗(yàn)證方式,目前支持sha1和sm3,不傳或傳入不合法時(shí),默認(rèn)使用:sha1 
sign 加密簽名算法,sign=sha1(appid+appkey+subuser+mobile+email+roleId+ts)
當(dāng)encode=sm3時(shí),sign=sm3(appid+appkey+subuser+mobile+email+roleId+ts)
點(diǎn)擊查看 簽名示例
subuser 創(chuàng)建子賬戶的用戶名,請(qǐng)使用絕對(duì)唯一性字段
mobile 創(chuàng)建子賬戶綁定的手機(jī)號(hào)碼,可選字段,留空時(shí)子賬戶的手機(jī)號(hào)碼為空;
email 創(chuàng)建子賬戶綁定的郵箱,可選字段,留空時(shí)子賬戶的郵箱為空;
roleId 創(chuàng)建子賬戶的角色,可選字段,留空默認(rèn)為“問卷管理員”
子賬戶角色:
1-系統(tǒng)管理員,2-問卷管理員,3-統(tǒng)計(jì)結(jié)果查看員,4-完整結(jié)果查看員
url 指定登錄成功后的跳轉(zhuǎn)地址,不傳時(shí)默認(rèn)跳轉(zhuǎn)到我的問卷頁面

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

創(chuàng)建:第一次使用以上接口時(shí),就是子賬戶的創(chuàng)建過程;

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

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

 

 

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

接口介紹

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

接口參數(shù)說明

請(qǐng)求方式:Get

接口鏈接http://embraceyourinnerleaderpodcast.com/zunxiang/getuserq.aspx?appid=&username=&ts=&folder=&sign=

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

此接口會(huì)有10分鐘的緩存時(shí)間,新增的問卷可能需要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://embraceyourinnerleaderpodcast.com/jq/89767.aspx","murl":"http://embraceyourinnerleaderpodcast.com/m/89767.aspx"},{"qid":"89819","name":"考試","begindate":"2017-08-18 21:21:35","answercount":"4","pcurl":"http://embraceyourinnerleaderpodcast.com/jq/89819.aspx","murl":"http://embraceyourinnerleaderpodcast.com/m/89819.aspx"}]

qid:問卷ID

name:問卷標(biāo)題

begindata:問卷的創(chuàng)建時(shí)間

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

 

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

接口介紹

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

接口參數(shù)說明

請(qǐng)求方式:Get

接口鏈接:http://embraceyourinnerleaderpodcast.com/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)前答卷序號(hào)

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

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

 

 

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

接口介紹

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

接口參數(shù)說明

請(qǐng)求方式:get

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

訪問其他頁面

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

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

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

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

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

非常感謝您的耐心閱讀,請(qǐng)?jiān)谙路教峁┠鷮?duì)本篇幫助的反饋,以便我們持續(xù)改進(jìn)本文。
已解決 未解決
長沙冉星信息科技有限公司 版權(quán)所有    ICP證:湘B2-20220508    湘ICP備17005436號(hào)-1    湘公網(wǎng)安備 43019002000245號(hào)
網(wǎng)站數(shù)據(jù)來源于問卷星官方數(shù)據(jù)庫    服務(wù)協(xié)議    隱私條款    舉報(bào)