幫助中心 >

免登錄賬戶(hù)API

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

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

1、免登錄接口

介紹

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

接口說(shuō)明

請求方式：get

加密鏈接參數如下：

http://nt-resale.com/partner/login.aspx?appid=&username=&mobile=&subuser=&ts=&sign=

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

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

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

2、用戶(hù)端接口

介紹

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

接口說(shuō)明

請求方式：get

加密鏈接參數如下：

http://nt-resale.com/partner/qlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

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

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

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

c) 獲取單份答卷詳情鏈接：
地址：http://nt-resale.com/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) 自主拼接用戶(hù)的單個(gè)問(wèn)卷訪(fǎng)問(wèn)鏈接：

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

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

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

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

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

介紹

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

數據獲取方式：get

接口說(shuō)明

加密鏈接參數如下：

http://nt-resale.com/partner/getuserq.aspx?appid=&username=&ts=&folder=&sign=

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

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

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

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

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

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

介紹

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

數據獲取方式：get

接口說(shuō)明

加密鏈接參數如下：

http://nt-resale.com/partner/getjoinlist.aspx?appid=&activity=&ts=&sign=&pageindex=&pagesize=

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

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

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

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

pageindex：頁(yè)碼序號

pagesize : 每頁(yè)數量，默認10條數據，每頁(yè)最多不超過(guò)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"}]