該功能接口僅限為旗艦版用戶提供
目錄
使用該接口,可以通過單點登錄(SSO)的方式創(chuàng)建子賬戶,創(chuàng)建成功之后可以通過此接口登錄子賬戶。使用此接口創(chuàng)建的用戶,屬于主賬戶下屬的子賬戶,權(quán)益同主賬戶同步。除創(chuàng)建和登錄方式不同外,其他權(quán)益、設(shè)置同手動創(chuàng)建的子賬戶完全一致。
請求方式:Get
接口鏈接:http://m.cgior.cn/zunxiang/login.aspx?appid=&subuser=&mobile=&email=&roleId=&ts=&sign=
參數(shù)名 | 參數(shù)說明 | 是否必須 |
---|---|---|
appid | 開發(fā)ID,需聯(lián)系客服生成,生成后可以在多用戶管理頁面查看 | 是 |
appkey | 開發(fā)秘鑰,需聯(lián)系客服生成,生成后可以在多用戶管理頁面查看 | 是 |
ts | 時間戳,從1970-01-01 00:00:00開始到現(xiàn)在的秒數(shù),有效期為60秒 | 是 |
encode | 簽名驗證方式,目前支持sha1和sm3,不傳或傳入不合法時,默認(rèn)使用:sha1 | 否 |
sign | 加密簽名算法,sign=sha1(appid+appkey+subuser+mobile+email+roleId+ts) 當(dāng)encode=sm3時,sign=sm3(appid+appkey+subuser+mobile+email+roleId+ts) 點擊查看 簽名示例 |
是 |
subuser | 創(chuàng)建子賬戶的用戶名,請使用絕對唯一性字段 | 是 |
mobile | 創(chuàng)建子賬戶綁定的手機(jī)號碼,可選字段,留空時子賬戶的手機(jī)號碼為空; | 否 |
創(chuàng)建子賬戶綁定的郵箱,可選字段,留空時子賬戶的郵箱為空; | 否 | |
roleId | 創(chuàng)建子賬戶的角色,可選字段,留空默認(rèn)為“問卷管理員” 子賬戶角色: 1-系統(tǒng)管理員,2-問卷管理員,3-統(tǒng)計結(jié)果查看員,4-完整結(jié)果查看員 |
否 |
url | 指定登錄成功后的跳轉(zhuǎn)地址,不傳時默認(rèn)跳轉(zhuǎn)到我的問卷頁面 | 否 |
創(chuàng)建:第一次使用以上接口時,就是子賬戶的創(chuàng)建過程;
登錄:子賬戶登錄和創(chuàng)建使用相同的接口,其中手機(jī)號碼、郵箱、角色三個字段,僅在首次創(chuàng)建時有效,在第二次登錄時如果三個字段信息有更改,也不會將傳遞信息更新到問卷星系統(tǒng);
刪除:如需刪除子賬戶,需要主賬戶登錄后,在多用戶管理頁面手動刪除。需要注意是:在您自己系統(tǒng)刪除一個員工賬戶后,無法自動同步刪除其在問卷星對應(yīng)的子賬戶。
通過此接口,可以獲取某一個子賬戶問卷管理員名下的問卷列表。
請求方式:Get
接口鏈接:http://m.cgior.cn/zunxiang/getuserq.aspx?appid=&username=&ts=&folder=&sign=
此接口會有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://m.cgior.cn/jq/89767.aspx","murl":"http://m.cgior.cn/m/89767.aspx"},{"qid":"89819","name":"考試","begindate":"2017-08-18 21:21:35","answercount":"4","pcurl":"http://m.cgior.cn/jq/89819.aspx","murl":"http://m.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: 移動端問卷訪問鏈接
通過此接口可以獲取到部分答卷數(shù)據(jù),包括:提交序號、參與者姓名、總分、提交時間、提交所用時間。需要注意的是,只有答卷總數(shù)少于20000才能使用此接口,而且此接口只能獲取到部分?jǐn)?shù)據(jù)而且全部答卷詳情數(shù)據(jù)。如需獲取全部答卷詳情數(shù)據(jù),可以參考:數(shù)據(jù)推送的API接口。
請求方式:Get
接口鏈接:http://m.cgior.cn/zunxiang/getjoinlist.aspx?appid=&activity=&ts=&sign=&pageindex=&pagesize=
數(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)前答卷的提示時間
使用該接口,做為問卷或考試填寫參與者的登錄之后,可看到一個完善的填寫參與者的用戶體系,查看到自己需要作答哪些問卷、已經(jīng)完成了哪些問卷、積分排行等等信息。
請求方式:get
加密鏈接參數(shù)如下:http://m.cgior.cn/zunxiang/qlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=
以上接口填寫者參與者點擊后訪問的是用戶體系的主頁,還可以通過攜帶參數(shù)訪問其他不同的頁面,如:
1、待參與頁面:http://m.cgior.cn/zunxiang/qlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=
2、已參與頁面:http://m.cgior.cn/zunxiang/qlistjoin.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=
3、答卷詳情頁:http://m.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)