帮助中心

自定义链接参数API

什么是自定义链接

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

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

场景案例

某市地铁公司在各站点分发满意度调查

使用要求

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

默认参数和添加题目参数

图片

1、默认参数

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

2、添加题目参数

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

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

参数的代入

1、开发组装链接参数

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

2、开发POST参数

「开发POST参数」也需要贵方开发人员参与,通过POST的方式,将参数带入。

POST地址:问卷的通用地址,可以在「链接与二维码」页面获取;

数据格式:x-www-form-urlencoded;

参数带入:以键值对形式带入,参数名及参数值的计算同「链接传参」一致。

3、手动填入

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

图片

关键参数

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

图片

数据查询

传递参数时带入isquery参数就可以控制当前访问是「作答」还是「查询」,其中参数值为0时为作答问卷,参数值为1时为查询答卷。isquery参数可以为空,为空时默认为作答问卷,isquery参数也不参与parmsign参数的签名计算。

安全配置

图片

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

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

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

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

DEMO

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

图片 图片

回传参数

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

图片

默认「sojumpparm」参数的回调写法{output},需特别注意「sojumpparm」的回调写法并非是{sojumpparm},如果传递sojumpparm有进行签名校验,那在跳转时也会带上wjxsign的签名参数以保证安全性。

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

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

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

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

图片

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

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