幫助中心 >

免登錄賬戶API

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

問卷星接口說明

1、免登錄接口

介紹

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

接口說明

請求方式：get

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

http://www.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ò)誤！請檢查sign計(jì)算是否正確。

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

2、用戶端接口

介紹

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

接口說明

請求方式：get

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

http://www.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://www.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://www.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://www.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://www.kaben.cc/partner/getuserq.aspx?appid=&username=&ts=&folder=&sign=

appid：由問卷星分配

appkey：由問卷星分配

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

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

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

提示：此接口會有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

介紹

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

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

接口說明

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

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

appid：由問卷星分配

appkey：由問卷星分配

activity：表示問卷的ID

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

pageindex：頁碼序號

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