免登录账户API

该功能接口仅限为尊享版用户提供,需联系服务顾问开通。


问卷星接口说明

1、 免登录接口

2、用户端接口

3、 获取管理员名下的问卷列表

4、获取答卷数据API

1、免登录接口

介绍

即单点登录接口,此接口适用于在已有用户体系下,用户可以在已有系统中点击问卷调查的模块即可直接使用问卷星的所有功能,无需另外再注册登录问卷星。

接口说明

请求方式:get

加密链接参数如下:

https://www.wjx.cn/partner/login.aspx?appid=&username=&mobile=&subuser=&ts=&sign=


subuser:子账户参数,从属于username(可以被username用户进行管理),可选

sign 计算方法:sigh=sha1(appid+appkey+username+mobile+subuser+ts)

如页面返回信息:签名错误! 请检查sign计算是否正确。


提示:如果需要在iframe中使用免登录接口,由于safari浏览器对cookie的限制,必须使用JS脚本的方式进行嵌入: 
 <script  type='text/javascript' src='https://www.wjx.cn/handler/loginemed.ashx?url={url}&width=100%&height=100%'></script>
src中需要有3个参数:
{url}参数请使用https://www.wjx.cn/partner/login.aspx?appid=&username=&mobile=&ts=&sign=进行替换。width和height参数可选,默认为100%。

 

2、用户端接口

介绍

使用该接口,做为填写者的用户登录之后,可看到一个完善的填写者后台页面,查看到自己需要作答哪些问卷、已经完成了哪些问卷、积分排行等等信息。

接口说明

请求方式:get

加密链接参数如下:

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


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

获取答题者单独列表接口(参数跟上面的一样):
格式:JSON

获取填写者的待参与列表:
地址:http://www.wjx.cn/partner/getqlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=
获取填写者的已参与列表:
地址:http://www.wjx.cn/partner/getqlistjoin.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

获取单份答卷详情链接:
地址:http://www.wjx.cn/partner/joinrelquery.aspx?appid=&username=&joiner=&activity=&joinid=&realname=&dept=&extf=&ts=&sign=

签名sign=sha1(appid + appkey + username + joiner + 问卷ID + joinid+ realname + dept + extf + ts)


3、获取管理员名下的问卷列表

介绍

通过此接口,可以获取某一个问卷管理员名下的的问卷列表。

数据获取方式:get

接口说明

加密链接参数如下:

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

appid:由问卷星分配

appkey:由问卷星分配

folder:用户名下的问卷文件夹名称。如加了该参数,则只会获取到指定文件夹里面的问卷数据,如果需要全部问卷数据,可以不加。

ts:为按秒计数的当前时间戳,通常对应time()函数,系统确认ts是在30s内,并且sign一致,就会自动登录

username:使用者的用户名或用户ID,由用户自己生成

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.wjx.cn/partner/getjoinlist.aspx?appid=&activity=&ts=&sign=&pageindex=&pagesize=

appid:由问卷星分配

appkey:由问卷星分配

activity:表示问卷的ID

ts:为按秒计数的当前时间戳,通常对应time()函数,系统确认ts是在30s内,并且sign一致,才能获取

pageindex:页码序号

pagesize : 每页数量,默认10条数据,每页最多不超过1000条数据

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的计算方式为:
sign = sha1(totalvalue+"asfw8aslfda899asfdaweasd"),
示例:如果用户得分为77.5分,那么参数值为sha1(77.5asfw8aslfda899asfdaweasd)

以上功能仅对尊享版开放

非常感谢您的耐心阅读,请在下方提供您对本篇帮助的反馈,以便我们持续改进本文。
已解决 未解决
长沙冉星信息科技有限公司 版权所有    ICP证:43019002000245    湘ICP备17005436号-1    湘公网安备 43019002000245号   认证联盟   举报
网站数据来源于问卷星官方数据库