免登錄賬戶API

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


問卷星接口說明

1、 免登錄接口

2、用戶端接口

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

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

1、免登錄接口

介紹

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

接口說明

請求方式:get

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

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


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

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


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

 

2、用戶端接口

介紹

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

接口說明

請求方式:get

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

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


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

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

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

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

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

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

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

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

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

介紹

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

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

接口說明

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

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

appid:由問卷星分配

appkey:由問卷星分配

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

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

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

提示:此接口會有10分鐘的緩存時間,新增的問卷可能需要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

介紹

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

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

接口說明

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

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

appid:由問卷星分配

appkey:由問卷星分配

activity:表示問卷的ID

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

pageindex:頁碼序號

pagesize : 每頁數(shù)量,默認10條數(shù)據(jù),每頁最多不超過1000條數(shù)據(jù)
sign計算方法:
      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ù)

介紹

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

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

非常感謝您的耐心閱讀,請在下方提供您對本篇幫助的反饋,以便我們持續(xù)改進本文。
已解決 未解決
長沙冉星信息科技有限公司 版權(quán)所有    ICP證:湘B2-20220508    湘ICP備17005436號-1    湘公網(wǎng)安備 43019002000245號
網(wǎng)站數(shù)據(jù)來源于問卷星官方數(shù)據(jù)庫    服務(wù)協(xié)議    隱私條款    舉報