帮助中心

数据推送API

目录(此功能为旗舰版功能)

一、数据推送API

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

三、数据推送DEMO

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

一、数据推送API

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

数据PostURL:由您指定,但是必须为外网可访问的地址,如:https://www.wjx.cn/demo/getapipost.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)推送失败,可勾选“失败自动重发”选项。如连续推送失败超过10次,系统将不再向该url推送数据,30分钟后会继续发送,如果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);

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

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

获取接口:https://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格式):https://www.wjx.cn/handler/IllustrateApi.ashx?activityID=问卷ID&JSON=1

三、数据推送DEMO

1、设置测试推送地址

将该地址: https://www.wjx.cn/demo/getapipost.aspx 放在数据推送的目标地址。注意,该地址仅用于测试,只显示最近300条推送数据。

2、查看推送结果

访问该地址:https://www.wjx.cn/demo/getapipost.aspx 可以查看测试DEMO获取到的数据详情。

注意:

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

非常感谢您的耐心阅读,请在下方提供您对本篇帮助的反馈,以便我们持续改进本文。
已解决 未解决
  • 400-993-5858
  • cs@wjx.cn
  • 问卷调查网站,广告合作 广告合作
    请扫码添加专员
    广告合作
  • 招商咨询
长沙冉星信息科技有限公司 版权所有    ICP证:湘B2-20220508    湘ICP备17005436号-1    湘公网安备 43019002000245号
网站数据来源于问卷星官方数据库    服务协议    隐私条款    举报