帮助中心 > 自定义链接

问卷星API介绍:

一、填写问卷时传递参数(如,用户ID)

通过使用自定义链接可以通过在问卷链接中传递参数(如,您系统中的用户ID)到问卷中,并保存在问卷数据中。同时在填写完成问卷后访问您指定的页面并带入此参数进行后续处理(例如赠送积分或优惠卷给此用户)。

使用场景:以CRM系统为例,问卷星的用户希望对CRM系统中的客户进行满意度问卷调查跟踪,需要将CRM中的用户ID与问卷星中的答卷进行关联。这样的应用场景非常普遍,问卷星的API完全可以满足类似场景的需求。通过API的方式,即确保了用户方的内部数据安全(只需要传递ID参数),又确保了问卷星数据与企业内部系统数据进行关联。

1、自定义问卷链接

参数名:sojumpparm

数据类型:string(如果包含中文或特殊字符请使用UrlEncode编码)

最大长度:100个字符(编码后)

传递参数数量:1个(如需传递多个,请在您系统中合并为一个后,再进行传递)

加密传递:您可以在您系统中加密后,在传递加密后的内容

完整的链接示例:http://www.wjx.cn/jq/3795229.aspx?sojumpparm=wenjuanxing

2、查看答卷来源

当填写者使用上面的自定义链接填写问卷并提交后,发布者在后台即可看到来源参数,如下图:

3、设置回传链接地址

如果您需要将此参数回传到您的系统中,请在“问卷设置”中设置回传的页面地址,并在回传地址最后加"?userid={output}",系统将自动把{output}替换为您在自定义链接中传入的参数。如下图所示:

设置回传地址示例:http://www.yourwebsite.com/complete.aspx?userid={output}

实际回传地址样例:http://www.yourwebsite.com/complete.aspx?userid=wenjuanxing

如有问题,请联系我们

二、数据推送API

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

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

POST http://yourdomain.com/callback Content-Type: application/json

示例问卷对应的json数据 {"activity": "5657754","timetaken":"528","submittime":"2016-08-23 10:01:59", "q1":"1","q2": "测试","q3","1,2" } 解析如下:

activity表示该问卷的ID;

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

submittime表示提交的时间点;

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

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

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

提示:(1)部分复杂题型不能推送,比如矩阵类型题目、表格类型题目等。(2)推送失败,系统会自动重新推送。如果1分钟内连续出错超过3次,该问卷的数据推送过程将被暂停30分钟。

开发指南:

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字符串:

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

更多开发接口

更多开放接口
非常感谢您的耐心阅读,请在下方提供您对本篇帮助的反馈,以便我们持续改进本文。
已解决 未解决

长沙冉星信息科技有限公司 版权所有

    

ICP证:43019002000245

    

湘ICP备17005436号-1

    

湘公网安备 43019002000245号