自定义链接参数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=张三

关于循环评价题的自定义链接参数设置

比如用户在“循环评价题”中设置了20个被评价对象，但本次只需要用户固定评价其中的5个，则可以使用自定义链接进行设置，参数配置为对应的题号和被评价对象序号，各个序号用逗号隔开即可：如：q2=1,2

用户用配置了自定义链接参数作答，“循环评价题”中即可自动选中1、2个被评价对象，无需用户再进行选择

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