大家社区开发文档

问卷星接口说明

管理端免登录接口

介绍

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

接口说明

加密链接参数如下:
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)

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

介绍

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

接口说明

加密链接参数如下:
http://www.wjx.cn/partner/getuserq.aspx?appid=&username=&ts=&folder=&sign=
appid:由问卷星分配
appkey:由问卷星分配
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"}]

用户端接口

介绍

使用该接口,做为填写者的用户登录之后,可以查看到自己需要作答哪些问卷,已经完成了哪些问卷。

接口说明

加密链接参数如下:
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)

数据推送API

介绍

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

接口说明

数据格式: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表示问卷名称
timetaken表示从打开问卷到填写提交所用时间,528表示528秒;
submittime表示提交的时间点;
q1表示第1题,值“1”表示用户选择了第一个选项;
q2表示第2题,值“测试”表示用户输入的内容;
q3表示第3题,值“1,2”表示用户同时选择了第1个和第2个选项。

获取答卷数据API

介绍

通过此接口可以直接会获取所有参与者的得分数据,包括:提交序号、参与者姓名、总分、提交时间、提交所用时间,该考试题目的数据。

接口说明

加密链接参数如下:
http://www.wjx.cn/partner/getjoinlist.aspx?appid=&activity=&ts=&sign=&pageindex=
appid:由问卷星分配
appkey:由问卷星分配
activity:表示问卷的ID
ts:为按秒计数的当前时间戳,通常对应time()函数,系统确认ts是在30s内,并且sign一致,才能获取
pageindex:页码序号,每页默认10条数据
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号  工商网监   工商网监 认证联盟