> ## Documentation Index
> Fetch the complete documentation index at: https://jinshuju-20a27453.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# URL 传参

> 当需要通过 API 获取或提交表单数据，实现系统集成时，可使用 API 接口功能。

URL 传参的运行原理如下图所示。为了保证数据在传输过程中不被窃取和利用，我们在传输参数时进行了加密处理。

![通用|数据|系统流程图金数据用户x系统间数据流转含「url传参」标注](https://help-assets.jinshuju.net/assets/file/14255/%E7%A4%BA%E4%BE%8B%E5%9B%BE.png)

***

## 效果示例

例如：在填表人打开金数据表单之前，可能已经通过你的自有系统完成身份认证和权限校验，或者你自有系统的一些数据收集。在填表人打开表单时，将这些信息传入到金数据表单中，无需填表人再次手工输入。

URL 传参功能可以实现如下效果：

* 填表者视角：

![通用|表单填写|「你有多大可能把我们推荐给朋友或同事」0-10分评分条](https://help-assets.jinshuju.net/assets/file/14256/%E5%A1%AB%E8%A1%A8%E8%80%85%E8%A7%86%E8%A7%92.png)

* 管理员视角：

![PC|数据|报表红框标注「用户名」「User ID」「注册手机」三列](https://help-assets.jinshuju.net/assets/file/14258/%E7%AE%A1%E7%90%86%E5%91%98%E8%A7%86%E8%A7%92.png)

***

## 功能亮点

可以对传入的参数进行填写次数限制。例如：当我们将已有系统中的「客户 ID」传入表单后，基于「客户 ID」，可以在表单设置「每客户 ID 仅限填写一次」。

![PC|表单设置|规则红框标注「填几次」为「每User ID 限填一次」](https://help-assets.jinshuju.net/assets/file/14261/%E9%99%90%E5%A1%AB%E8%AE%BE%E7%BD%AE.png)

这样，当客户提交后再次打开这个链接时，表单就会提示客户无法再次提交。

<img src="https://mintcdn.com/jinshuju-20a27453/6_cw5VCgAXk0lmwc/v4/attachments/ksLv7ekk6usDZfecCPyMgWK3.png?fit=max&auto=format&n=6_cw5VCgAXk0lmwc&q=85&s=221150721fd518b21f7b7f6103b1ea2b" alt="PC|数据|数据列表页面点击「API」按钮查看接口地址" width="1916" height="840" data-path="v4/attachments/ksLv7ekk6usDZfecCPyMgWK3.png" />

***

## 开启试用

在 [主页](https://jinshuju.net/home) 顶部点击「试用企业套餐」，或在「系统设置- [套餐概览](https://jinshuju.net/system)」右上角可以点击「试用企业功能」，首次试用你将获得 7 天的试用期，体验 23,999 元/年的**企业高级版**所有功能。

<img src="https://mintcdn.com/jinshuju-20a27453/qCEgiy_WXHXKMNNA/v4/attachments/umnoCM2rNL8ZGAYV15DLUr7L.png?fit=max&auto=format&n=qCEgiy_WXHXKMNNA&q=85&s=a91a1a1a6082ac21d5f1994ea7299fc8" alt="PC|数据|API弹窗显示「数据推送地址」和「Entry ID」" width="1480" height="784" data-path="v4/attachments/umnoCM2rNL8ZGAYV15DLUr7L.png" />

<img src="https://mintcdn.com/jinshuju-20a27453/lpVaY_eqU8NMCSd_/v4/attachments/JvEpfgFwfrHMNCpqKHmFLkAK.png?fit=max&auto=format&n=lpVaY_eqU8NMCSd_&q=85&s=6a94d58ab231da86eb1e71028a3f48e3" alt="PC|导航栏|顶部菜单含「表单」「数据」「设置」「扩展」等入口" width="1463" height="849" data-path="v4/attachments/JvEpfgFwfrHMNCpqKHmFLkAK.png" />

***

## URL 传参功能常见问题

### Q1：「URL 传参功能」和「跟踪数据来源」、「预填写」有什么区别应该怎么选择？

**答**：扩展属性本质是受限版的URL传参（仅支持单一固定参数）；URL传参提供最大灵活性和可扩展性；预填写提供最高安全级别但灵活性最低。具体差别如下：

**1. URL 传参（field\_参数）：**

* **功能定位**：通用的表单字段自动赋值方案

* **典型格式**：`https://jinshuju.com/f/{token}?field_1=value1&field_2=value2`

* **核心特点**：

  * 支持批量赋值任意多个表单字段

  * 支持签名机制防止参数篡改

  * 传入数据直接填充到对应表单字段（通常配合字段隐藏）

* **适用场景**：

  * 外部系统对接

  * 多维度数据传递（渠道号、工号、业务参数等）

  * 需要防篡改的数据传输

**2. 扩展属性追踪（x\_field\_1）**

* **功能定位**：轻量级的数据来源标记

* **典型格式**：`https://jinshuju.com/f/{token}?x_field_1=channel_123`

* **核心特点**：

  * 每个表单仅支持一个扩展属性

  * 参数名固定为 x\_field\_1

  * 数据存储在后台「扩展属性」列，不在表单内容中显示

  * 无签名保护，参数可被用户修改

* **适用场景**：

  * 单一维度的数据归因

  * 对安全性要求不高的标识追踪

**3. 预填写**

* **功能定位**：高安全性的定向数据分发

* **核心特点**：

  * 后台预配置数据，系统生成随机专属参数链接

  * 链接无规律，无法推测或篡改

* **适用场景**：

  防止数据关联和篡改的场景

## URL 传参功能相关资费介绍

URL传参的资费介绍如下：

| | 免费版 | 专业版 | 专业增强版 | 企业基础版 | 企业协作版 | 企业高级版 |
| - | - | - | - | - | - | - |
| 价格 | 免费 | 599 元/年 | 2,399 元/年，299 元/月 | 4,399 元/年 | 7,399 元/年 | 23,999 元/年 |
| URL 传参 | - | - | - | - | - | ✔️ |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.