URL 传参

URL 传参可以在填表人打开表单链接时，把你自有系统中已有的身份或业务参数（如客户 ID、工号、手机号）直接带入对应的表单字段。填表人无需重复录入，表单创建者也能在数据中看到每条数据对应的填表人身份。该功能为企业高级版专属。

URL 传参的工作原理

填表人在你的自有系统中完成身份认证或权限校验后，系统把已有的用户信息拼接到表单链接的参数中；填表人打开这个链接时，参数值会自动填入对应的表单字段，随数据一并提交到金数据。

链接的典型格式如下，field_1、field_2 是表单中对应字段的 API Code，sign 是用账户密钥算出的数据校验签名：

https://jinshuju.net/f/{token}?field_1=value1&field_2=value2&sign=SIGNATURE

为防止参数在传输过程中被窃取或篡改，表单只接受签名校验通过的参数。

传参后填表人和表单创建者看到什么

URL 传参暂不支持在填写页回显传入的值，因此建议把接收数据的字段设为隐藏。这样填表人只会看到需要本人回答的问题，看不到已经带入的身份信息。

表单创建者在「数据报表」中可以看到每条数据对应的「用户名」「User ID」「注册手机」等由 URL 传入的信息。

怎么配置 URL 传参

配置前要先在表单中创建好用于接收数据的字段。例如要传入用户姓名和部门，就要在表单里先添加「用户姓名」和「用户部门」两个字段（可以是姓名字段、单行文本字段等）。

1. 在表单结构中获取各字段的 API Code，形如 field_1、field_2；不同表单的 API Code 可能不同。
2. 把要传入的字段按 key=value 拼成参数字符串，例如 field_1=James&field_2=13888888888。字段的 API Code 必须按升序排列，顺序不对签名校验不会通过；参数值中如果含特殊字符，需要先做 URL Encode 转义。
3. 获取账户密钥 sign_secret。密钥仅企业高级版可用，请联系你的客户成功经理获取。
4. 用密钥对参数字符串做 HMAC SHA256 运算生成签名，再对签名做 Base64 编码。
5. 把参数和编码后的签名拼成最终链接，分发给填表人。

最终链接的格式如下：

https://jinshuju.net/f/{token}?field_1=James&field_2=13888888888&sign=encoded_sign

拼好的链接可以用 表单字段传参签名生成工具 在线生成和校验；Java、Python、Ruby 的完整示例代码见开放平台的 表单字段 URL 传参 文档。

基于传入的参数限制填写次数

传入的参数可以直接作为限填依据。例如把自有系统中的「User ID」传入表单后，在「表单设置 → 填写规则」中把「填几次」设为「仅限填写一次」，并把限填方式选为「每 User ID」限填一次。

设置后，同一个 User ID 提交过再次打开链接时，表单会提示填表人已达限填次数，无法再次提交。

URL 传参、扩展属性追踪、预填写怎么选

三者都能把外部参数带进表单，区别在于灵活性和安全性：扩展属性追踪是受限版的 URL 传参，只支持一个固定参数；URL 传参最灵活、可扩展；预填写安全级别最高，但灵活性最低。

URL 传参（field_ 参数）

• 典型格式：https://jinshuju.net/f/{token}?field_1=value1&field_2=value2&sign=SIGNATURE；
• 支持一次给任意多个表单字段赋值；
• 支持签名机制，可防止参数被篡改；
• 传入的值直接填充到对应表单字段，通常配合字段隐藏使用；
• 适用于外部系统对接、多维度数据传递（渠道号、工号、业务参数等）、需要防篡改的数据传输。

扩展属性追踪（x_field_1）

• 典型格式：https://jinshuju.net/f/{token}?x_field_1=channel_123；
• 每个表单仅支持一个扩展属性，参数名固定为 x_field_1；
• 数据存储在后台的「扩展属性」列，不在表单内容中显示；
• 无签名保护，参数可被填表人修改；
• 适用于单一维度的数据归因、对安全性要求不高的标识追踪。

预填写

• 在后台预先配置数据，由系统生成随机的专属参数链接；
• 链接无规律，无法推测或篡改；
• 适用于需要防止数据关联和篡改的场景。

三者所需套餐不同，请按下表确认可用性：

常见报错

打开链接提示「URL 参数和签名不匹配」

出现该提示说明链接携带的签名与参数对不上，表单不会接受传入的参数。常见原因：

• 参数没有按字段 API Code 升序排列；
• 参数值中含特殊字符，但没有做 URL Encode 转义；
• 改动参数值后没有重新生成签名；
• 生成签名用的不是本账户的 sign_secret。

可以用 表单字段传参签名生成工具 校验参数与签名是否匹配。

怎么开启企业高级版试用

首次试用可获得 7 天试用期，体验企业高级版的所有功能。在 主页 顶部点击「试用企业套餐」。

也可以在「系统设置 → 套餐概览」右上角点击「试用企业功能」。

URL 传参需要什么套餐

URL 传参为企业高级版专属功能，其余套餐不支持。

各套餐的完整功能对比见 套餐与价格。