帮助中心 > API

数据推送API

该功能接口仅限为尊享版用户提供,需联系尊享版客服开通。联系电话:13873104423(同微信号),也可直接扫码加尊享版客服微信咨询:

目录

一、数据推送API

二、获取题目选项对应文本内容

三、数据推送DEMO

如果您需要将答卷数据备份到自己的服务器中,可以使用本接口,将提交的答卷Post到您指定的URL,并保存。

一、数据推送API

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

数据PostURL:由您指定,但是必须为外网可访问的地址,如:http://wjxapi.paperol.cn/getapi.aspx(Demo地址)

推送数据示例:

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

推送参数说明:
注:系统会自动加上签名参数,参数名为"sign",计算方式为:sign=sha1(activity+index+推送密钥),其中activity和index代表问卷ID和作答序号,可以在推送数据中直接获取,推送密钥请联系尊享版客服获取。

注意事项:

(1)推送失败,系统会自动重新推送。如果1分钟内连续出错超过3次,该问卷的数据推送过程将被暂停30分钟;

(2)如果使用了数据推送API,同时也使用了自定义链接参数,sojumpparm参数带进来的内容也会推送,无需使用“自定义链接参数”功能中的页面跳转传递参数。

(3)点击此处可以查看各题型的推送示例详情

开发指南:

1、PHP获取Json数据:可以使用file_get_contents("php://input")或者$GLOBALS['HTTP_RAW_POST_DATA']

2、Python django:可以使用request.raw_post_data来获取Json数据

3、java代码:使用org.apache.commons.io.IOUtils来获取json字符串:

  1. String jsonString = IOUtils.toString(request.getInputStream());
  2. JSONObject json = new JSONObject(jsonString);

4、C#代码:读取Request.InputStream数据:

  1. Stream stream = Request.InputStream;
  2. Byte[] byteData = new Byte[stream.Length];
  3. stream.Read(byteData, 0, (Int32)stream.Length);
  4. string jsonData = Encoding.UTF8.GetString(byteData);

二、获取题目选项对应文本内容

在数据推送时,为保证推送速度及成功率,只会推送题目及选项对应的序号,不会推送题目及选项的文本内容,如需获取题目选项序号和文本的对应值,可以使用以下接口获取:

获取接口: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.考试问卷,不包含正确答案的信息。

获取接口(JSON格式):http://www.wjx.cn/handler/IllustrateApi.ashx?activityID=问卷ID&JSON=1

三、数据推送DEMO

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

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

2、设置测试推送地址

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

3、查看推送结果

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

注意:

测试环境,请勿推送敏感数据。

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