数据推送API

如果您需要将某个问卷新提交的数据推送到指定URL,您可以使用此API。尊享版该API默认是开启状态

一、数据推送API介绍

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

例如指定URL为http://yourdomain.com/callback,则问卷星会以JSON格式POST该答卷数据到指定的URL。

推送服务器IP地址:120.26.38.11  

数据格式:JSON

数据示例:

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

activity表示该问卷的ID;

name表示问卷名称;

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

submittime表示提交的时间点;

joinid表示该答题者是我们平台的第多少个答题者;

totalvalue表示总分。

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

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

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


如使用了用户体系,会推送以下数据:

thirdusername——用户ID

realname——姓名

relDept——部门

relExt——附加信息


提示:(1)推送失败,系统会自动重新推送。如果1分钟内连续出错超过3次,该问卷的数据推送过程将被暂停30分钟。(2)如果使用了数据推送API,同时也使用了自定义链接参数,sojumpparm参数带进来的内容也会推送,无需使用“自定义链接参数”功能中的页面跳转传递参数。

二、测试环境


1、检测测试环境是否在线;

因为测试环境搭建在本地,不是24小时在线。所以首先需要打开这个地址:http://wjxapi.paperol.cn/index.html 如果页面可以正常访问,表示测试环境正常。如果页面无法正常访问,表示测试环境处于离线状态。可以联系客服恢复测试环境。

2、设置测试推送地址;

将该地址:http://wjxapi.paperol.cn/getapi.aspx 放在数据推送的目标地址。注意,该地址仅用于测试,测试数据会定期删除,请勿用于实际使用环境。

3、查看推送结果;

访问该地址:http://wjxapi.paperol.cn/data.txt 可以查看测试状态获取到的数据详情。


注意:(1)测试环境,请勿推送敏感数据;(2)由于该页面直接访问的是保存的数据文件,中文会出现乱码现象,获取存储在本地的数据无乱码,也可以直接用迅雷等下载工具下载本文件到本地查看。


三、获取问卷文本内容


数据推送API默认只推送答卷数据,问卷内容是不会推送的,如需获取问卷文本内容,可以使用获取文本接口。

该接口仅限尊享版用户使用,请联系尊享版服务专员(手机微信同号:18175968311),申请开通。

获取接口:

http://www.wjx.cn/handler/IllustrateApi.ashx?activityID={问卷ID}

 

解释:

1.q1、q2、q3以此类推,代表每个题目的题干文字;

2.选择类的题目,q1#1、q1#2、q1#3分别代表第一个题的第一个、第二个、第三个选项;

3.多项填空题,只提供题干整体文本;

4.如果是矩阵单选或矩阵多选题,q1是题干文本,q1_1,q1_2是矩阵题的第一个、第二个左行标题,q1_1#1,q1_1#2分别是矩阵题第一个左行标题的,第一个选项、第二个选项内容。

5.矩阵填空,数据推送的时候直接推送的是选项内容,无需获取选项文本。类似的还有矩阵滑动条、表格下拉框、表格数值、表格文本题。

6.考试问卷,不包含正确答案的信息。

以上功能只对尊享版开放



更多API接口