帮助中心

自定义链接参数API

什么是自定义链接

自定义链接是指:可以在普通问卷链接的基础上添加参数,将参数值传递到问卷中,并存储为问卷的答卷数据。

例如:您有自己的用户系统,在为用户配置问卷参与链接时,可以通过参数带入用户的各种信息,跟踪答题状态,回传作答状态及数据。

使用要求

免费版用户无法使用自定义链接的功能。企业版本可使用默认的「sojumpparm」参数,无法添加更多参数。尊享版及以上,不仅可以使用默认的「sojumpparm」参数,还可以添加更多的参数。

默认参数和添加题目参数

图片

1、默认参数

问卷星默认会提供一个「sojumpparm」参数,通过此参数传递进来的数据,会保存在答卷的「来源详情」的字段。该参数为:string类型(如果包含中文或特殊字符请使用UrlEncode编码)、最大长度为100个字符。

2、添加题目参数

如果需要传递更多的参数,可以在页面上点击「添加参数」,这里添加的参数必须是问卷中的「填空题」、「单选题」或「多级下拉题」,所以需要在设计问卷时添加好对应的问卷题目,如果不想让填写者看到这些题目,可以将这些题目设置为隐藏状态。

题目参数传递进来的数据,会存储在对应的题目数据中,同填写者正常作答的数据一致。题目参数的类型依据对应的题目类型的不同而不同,如「填空题」为字符串类型,「单选题」「多级下拉题」为选择类型。

参数的来源

1、开发组装

一般来说使用「自定义链接」都需要贵方开发人员参与,依据本篇文档进行自定义链接参数的组装,带入贵方系统中的必要字段。需要注意的是:如果添加了多个参数,则只能通过「开发组装」的方式来使用「自定义链接」。

2、手动填入

如果只使用一个参数,则可以在问卷星后台手动批量生成带参数的链接。如果是「sojumpparm」默认参数和「字符串」的参数,可以批量上传一批参数值然后下载获取对应的链接与二维码。如果是「选择类」参数,则无需上传就可以直接批量导出带参数的链接与二维码。

图片

关键参数

关键参数是用来控制「 每个关键参数值可作答次数」这个功能的,默认情况下是「sojumpparm」这个参数,添加多个参数后可以修改为其他的参数。

图片

安全配置

图片

1、「只允许从自定义链接访问」,勾选后只能通过自定义链接参数作答,普通问卷链接会提示无法访问。

2、「增加过期时间」,勾选后生成的自定义链接参数会增加一个过期时间戳字段(endts),超过后链接将失效。

3、「校验参数签名」,勾选后生成的自定义链接参数会增加一个签名字段(parmsign),如果有人篡改参数值,链接将失效。

4、「提交后再次访问可查询作答记录」,勾选后用户在「没有达到访问次数」前可以正常访问作答,在「达到访问次数」后将直接进入答卷页面。需要注意的是:这里的设置效果同「 每个关键参数值可作答次数」有强关联。

DEMO

为了方便用户进行开发调试,增加的任何参数或设置,均可以在「链接参数URL预览」中体现,并且系统还提供了一个「DEMO」生成的功能,可以手动输入参数进行调用测试。

图片 图片

回传参数

带入的参数,如果想回调到自己系统,可以在「设计问卷」》「问卷设置」》「提交后显示」》「跳转到指定页面」中设置一个回调地址,并且按如下规则在回调地址中写入之前带入的参数。

图片

默认「sojumpparm」参数的回调写法{output},需特别注意「sojumpparm」的回调写法并非是{sojumpparm}。

q1参数的回调写法为{q1},其他序号题目依次类推。

在问卷页面中显示带进来的参数

问卷页面支持将默认的「sojumpparm」参数显示在段落说明或题干中。插入方法:将[sojumpparm]这个字段输入在段落说明或题干中,如下图所示(显示带进来的参数仅限尊享版用户使用):

示例:https://www.wjx.cn/jq/37943379.aspx?sojumpparm=张三

图片

自定义链接参数API_旧版文档

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