免登錄賬戶API

該功能接口僅限為旗艦版用戶提供，需聯系服務顧問開通。

問卷星接口說明

1、 免登錄接口

2、用戶端接口

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

4、獲取答卷數據API

1、免登錄接口

介紹

即單點登錄接口，此接口適用于在已有用戶體系下，用戶可以在已有系統中點擊問卷調查的模塊即可直接使用問卷星的所有功能，無需另外再注冊登錄問卷星。

接口說明

請求方式：get

加密鏈接參數如下：

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

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

如頁面返回信息：簽名錯誤！ 請檢查sign計算是否正確。

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

2、用戶端接口

介紹

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

接口說明

請求方式：get

加密鏈接參數如下：

http://www.kaben.cc/partner/qlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

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

獲取答題者單獨列表接口（參數跟上面的一樣）：
格式：JSON
a) 獲取填寫者的待參與列表：
地址：http://www.kaben.cc/partner/getqlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=
sign計算方法：
      sign = sha1(appid+appkey+username+joiner+realname+dept+extf+ts)

b) 獲取填寫者的已參與列表：
地址：http://www.kaben.cc/partner/getqlistjoin.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=
sign計算方法：
      sign = sha1(appid+appkey+username+joiner+realname+dept+extf+ts)

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

d) 自主拼接用戶的單個問卷訪問鏈接：

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

2、替換ActivityUrl中的ts為當前時間；

3、重新計算并替換partersign的值；

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

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

介紹

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

數據獲取方式：get

接口說明

加密鏈接參數如下：

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

appid：由問卷星分配

appkey：由問卷星分配

folder：用戶名下的問卷文件夾名稱。如加了該參數，則只會獲取到指定文件夾里面的問卷數據，如果需要全部問卷數據，可以不加。

ts：為按秒計數的當前時間戳，通常對應time()函數，系統確認ts是在30s內，并且sign一致，就會自動登錄

username：使用者的用戶名或用戶ID，由用戶自己生成
sign計算方法：
      sign = sha1(appid+appkey+username+ts+folder)

提示：此接口會有10分鐘的緩存時間，新增的問卷可能需要10分鐘以后才能獲取。

數據格式：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"}]

4、獲取答卷數據API

介紹

通過此接口可以直接會獲取所有參與者的得分數據，包括：提交序號、參與者姓名、總分、提交時間、提交所用時間。只有答卷總數少于20000才能使用此接口。

數據獲取方式：get

接口說明

加密鏈接參數如下：

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

appid：由問卷星分配

appkey：由問卷星分配

activity：表示問卷的ID

ts：為按秒計數的當前時間戳，通常對應time()函數，系統確認ts是在30s內，并且sign一致，才能獲取

pageindex：頁碼序號

pagesize : 每頁數量，默認10條數據，每頁最多不超過1000條數據
sign計算方法：
      sign = sha1(appid+appkey+activity+ts)

數據格式：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"}]

6、設置完成問卷后跳轉并且有自定義鏈接參數時，考試會自動帶上分數

介紹

為防止用戶修改分數，系統除了會傳遞totalvalue參數外，還會傳遞valuesign參數。
valuesign的計算方式為：
      valuesign = sha1(totalvalue+"asfw8aslfda899asfdaweasd")

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