问卷星API接口总览

以下接口,只有购买问卷星尊享版之后,方可使用。详情请联系问卷星尊享版的服务专员,联系电话:18175968311,也可扫描微信详细咨询:

问卷星接口说明

1、 免登录接口

介绍

接口说明

2、用户端接口

介绍

接口说明

3、数据推送API

介绍

接口说明

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

介绍

接口说明

5、获取答卷数据API

介绍

接口说明

1、免登录接口

介绍

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

接口说明

加密链接参数如下:

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

appid:由问卷星分配

appkey:由问卷星分配

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

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

sign:sha1(appid+appkey+username+ts)

2、用户端接口

介绍

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

接口说明

加密链接参数如下:

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

appid:由问卷星分配

appkey:由问卷星分配

username:问卷发布者的用户名或用户ID,由用户自己生成

joiner:已有用户系统中,问卷填写者的ID

realname:已有用户系统中,问卷填写者的真实姓名

extf:附加字段,不能超过1000个字符,会通过回调API传回到您的的系统中。可设置传递部门、岗位等信息,作为填写者信息的补充。

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

sign:sha1(appid + appkey + username+joiner+realname + extf + ts)

3、数据推送API

介绍

使用该接口,可以将填写者提交的数据推送到指定的URL,推送数据的格式是JSON,您需要提供接受数据的URL,并且在此 URL上写程序接收数据。

数据获取方式:post

接口说明

数据格式:JSON

数据示例:

{"activity":"5657754","name":"问卷名称","parteruser":"15581018823","parterjoiner":"test4","timetaken":"528","submittime":"2016-08-23 10:01:59", "q1":"1","q2": "测试","q3","1,2","totalvalue":"15"}

activity表示该问卷的ID;

name表示问卷名称;

partneruser表示发布者用户名;

partnerjoiner表示答题者;

timetaken表示从打开问卷到填写提交所用时间,528表示528秒;

submittime表示提交的时间点;

q1表示第1题,值“1”表示用户选择了第一个选项;

q2表示第2题,值“测试”表示用户输入的内容;

q3表示第3题,值“1,2”表示用户同时选择了第1个和第2个选项。

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

介绍

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

数据获取方式: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"}]

5、获取答卷数据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"}]

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