免登錄賬戶(hù)API

該功能接口僅限為旗艦版用戶(hù)提供,需聯(lián)系服務(wù)顧問(wèn)開(kāi)通。


問(wèn)卷星接口說(shuō)明

1、 免登錄接口

2、用戶(hù)端接口

3、 獲取管理員名下的問(wèn)卷列表

4、獲取答卷數(shù)據(jù)API

1、免登錄接口

介紹

即單點(diǎn)登錄接口,此接口適用于在已有用戶(hù)體系下,用戶(hù)可以在已有系統(tǒng)中點(diǎn)擊問(wèn)卷調(diào)查的模塊即可直接使用問(wèn)卷星的所有功能,無(wú)需另外再注冊(cè)登錄問(wèn)卷星。

接口說(shuō)明

請(qǐng)求方式:get

加密鏈接參數(shù)如下:

http://m.cgior.cn/partner/login.aspx?appid=&username=&mobile=&subuser=&ts=&sign=


subuser:子賬戶(hù)參數(shù),從屬于username(可以被username用戶(hù)進(jìn)行管理),可選
sign計(jì)算方法:
      sign = sha1(appid+appkey+username+mobile+subuser+ts)

如頁(yè)面返回信息:簽名錯(cuò)誤! 請(qǐng)檢查sign計(jì)算是否正確。


提示:如果需要在iframe中使用免登錄接口,由于safari瀏覽器對(duì)cookie的限制,必須使用JS腳本的方式進(jìn)行嵌入: 
 <script  type='text/javascript' src='http://m.cgior.cn/handler/loginemed.ashx?url={url}&width=100%&height=100%'></script>
src中需要有3個(gè)參數(shù):
{url}參數(shù)請(qǐng)使用http://m.cgior.cn/partner/login.aspx?appid=&username=&mobile=&ts=&sign=進(jìn)行替換。width和height參數(shù)可選,默認(rèn)為100%。

 

2、用戶(hù)端接口

介紹

使用該接口,做為填寫(xiě)者的用戶(hù)登錄之后,可看到一個(gè)完善的填寫(xiě)者后臺(tái)頁(yè)面,查看到自己需要作答哪些問(wèn)卷、已經(jīng)完成了哪些問(wèn)卷、積分排行等等信息。

接口說(shuō)明

請(qǐng)求方式:get

加密鏈接參數(shù)如下:

http://m.cgior.cn/partner/qlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=


sign計(jì)算方法:
      sign = sha1(appid+appkey+username+joiner+realname+dept+extf+ts)

獲取答題者單獨(dú)列表接口(參數(shù)跟上面的一樣):
格式:JSON

a) 獲取填寫(xiě)者的待參與列表:
地址:http://m.cgior.cn/partner/getqlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=
sign計(jì)算方法:
      sign = sha1(appid+appkey+username+joiner+realname+dept+extf+ts)

b) 獲取填寫(xiě)者的已參與列表:
地址:http://m.cgior.cn/partner/getqlistjoin.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=
sign計(jì)算方法:
      sign = sha1(appid+appkey+username+joiner+realname+dept+extf+ts)

c) 獲取單份答卷詳情鏈接:
地址:http://m.cgior.cn/partner/joinrelquery.aspx?appid=&username=&joiner=&activity=&joinid=&realname=&dept=&extf=&ts=&sign=
sign計(jì)算方法:
      sign = sha1(appid+appkey+username+joiner+activity+joinid+realname+dept+extf+ts)

d) 自主拼接用戶(hù)的單個(gè)問(wèn)卷訪問(wèn)鏈接:

1、使用a) 獲取填寫(xiě)者的待參與列表,提取單個(gè)問(wèn)卷的訪問(wèn)鏈接,記錄為ActivityUrl;

2、替換ActivityUrl中的ts為當(dāng)前時(shí)間;

3、重新計(jì)算并替換partersign的值;

partersign = sha1(appid+appkey+username+joiner+realname+dept+extf+ts)

3、獲取管理員名下的問(wèn)卷列表

介紹

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

數(shù)據(jù)獲取方式:get

接口說(shuō)明

加密鏈接參數(shù)如下:

http://m.cgior.cn/partner/getuserq.aspx?appid=&username=&ts=&folder=&sign=

appid:由問(wèn)卷星分配

appkey:由問(wèn)卷星分配

folder:用戶(hù)名下的問(wèn)卷文件夾名稱(chēng)。如加了該參數(shù),則只會(huì)獲取到指定文件夾里面的問(wèn)卷數(shù)據(jù),如果需要全部問(wèn)卷數(shù)據(jù),可以不加。

ts:為按秒計(jì)數(shù)的當(dāng)前時(shí)間戳,通常對(duì)應(yīng)time()函數(shù),系統(tǒng)確認(rèn)ts是在30s內(nèi),并且sign一致,就會(huì)自動(dòng)登錄

username:使用者的用戶(hù)名或用戶(hù)ID,由用戶(hù)自己生成
sign計(jì)算方法:
      sign = sha1(appid+appkey+username+ts+folder)

提示:此接口會(huì)有10分鐘的緩存時(shí)間,新增的問(wèn)卷可能需要10分鐘以后才能獲取。

數(shù)據(jù)格式:JSON

數(shù)據(jù)示例: [{"qid":"89767","name":"新考試","begindate":"2017-08-20 11:52:43","answercount":"5"},{"qid":"89819","name":"考試","begindate":"2017-08-18 21:21:35","answercount":"4"}]

4、獲取答卷數(shù)據(jù)API

介紹

通過(guò)此接口可以直接會(huì)獲取所有參與者的得分?jǐn)?shù)據(jù),包括:提交序號(hào)、參與者姓名、總分、提交時(shí)間、提交所用時(shí)間。只有答卷總數(shù)少于20000才能使用此接口。

數(shù)據(jù)獲取方式:get

接口說(shuō)明

加密鏈接參數(shù)如下:

http://m.cgior.cn/partner/getjoinlist.aspx?appid=&activity=&ts=&sign=&pageindex=&pagesize=

appid:由問(wèn)卷星分配

appkey:由問(wèn)卷星分配

activity:表示問(wèn)卷的ID

ts:為按秒計(jì)數(shù)的當(dāng)前時(shí)間戳,通常對(duì)應(yīng)time()函數(shù),系統(tǒng)確認(rèn)ts是在30s內(nèi),并且sign一致,才能獲取

pageindex:頁(yè)碼序號(hào)

pagesize : 每頁(yè)數(shù)量,默認(rèn)10條數(shù)據(jù),每頁(yè)最多不超過(guò)1000條數(shù)據(jù)
sign計(jì)算方法:
      sign = sha1(appid+appkey+activity+ts)

數(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"}]

6、設(shè)置完成問(wèn)卷后跳轉(zhuǎn)并且有自定義鏈接參數(shù)時(shí),考試會(huì)自動(dòng)帶上分?jǐn)?shù)

介紹

為防止用戶(hù)修改分?jǐn)?shù),系統(tǒng)除了會(huì)傳遞totalvalue參數(shù)外,還會(huì)傳遞valuesign參數(shù)。
valuesign的計(jì)算方式為:
      valuesign = sha1(totalvalue+"asfw8aslfda899asfdaweasd")

示例:如果用戶(hù)得分為77.5分,那么參數(shù)值為sha1(77.5asfw8aslfda899asfdaweasd)

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