免登錄賬戶API

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

問卷星接口說明

1、 免登錄接口

2、用戶端接口

3、 獲取管理員名下的問卷列表

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

1、免登錄接口

介紹

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

接口說明

請(qǐng)求方式：get

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

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

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

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

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

2、用戶端接口

介紹

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

接口說明

請(qǐng)求方式：get

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

http://m.kaben.cc/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) 獲取填寫者的待參與列表：
地址：http://m.kaben.cc/partner/getqlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=
sign計(jì)算方法：
      sign = sha1(appid+appkey+username+joiner+realname+dept+extf+ts)

b) 獲取填寫者的已參與列表：
地址：http://m.kaben.cc/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.kaben.cc/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) 自主拼接用戶的單個(gè)問卷訪問鏈接：

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

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

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

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

3、獲取管理員名下的問卷列表

介紹

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

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

接口說明

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

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

appid：由問卷星分配

appkey：由問卷星分配

folder：用戶名下的問卷文件夾名稱。如加了該參數(shù)，則只會(huì)獲取到指定文件夾里面的問卷數(shù)據(jù)，如果需要全部問卷數(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：使用者的用戶名或用戶ID，由用戶自己生成
sign計(jì)算方法：
      sign = sha1(appid+appkey+username+ts+folder)

提示：此接口會(huì)有10分鐘的緩存時(shí)間，新增的問卷可能需要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

介紹

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

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

接口說明

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

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

appid：由問卷星分配

appkey：由問卷星分配

activity：表示問卷的ID

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

pageindex：頁碼序號(hào)

pagesize : 每頁數(shù)量，默認(rèn)10條數(shù)據(jù)，每頁最多不超過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è)置完成問卷后跳轉(zhuǎn)并且有自定義鏈接參數(shù)時(shí)，考試會(huì)自動(dòng)帶上分?jǐn)?shù)

介紹

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

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