URL 传参概述
金数据支持用户通过 URL 传参 向 对外发布的表单传入参数。这些参数可以被校验并且持久化到收集到的数据上。
有系统集成或者编程能力的用户,可以通过这些功能,将自有系统、第三方系统与金数据集成起来。
| 功能 | 免费版 | 专业版/专业增强版 | 企业基础版 | 企业协作版 | 企业高级版 |
|---|---|---|---|---|---|
| URL 传参 | ✔️ |
三种方式
| 功能 | 可以传入几个 | 是否支持校验 | 是否需要在表单上预设字段 | 系统集成复杂度 |
|---|---|---|---|---|
| 扩展属性 | 1个 | 否 | 无需 | 简单 |
| 表单字段传参 | 多个 | 是 | 需要 | 较复杂 |
| 全局字段传参 | 多个 | 是 | 无需 | 较复杂 |
扩展属性
金数据表单 扩展属性 功能,支持在发布出去的表单,传一个 URL 参数,这样子最终填表人在提交表单时,会在表单数据上回填这个参数。
发布表单的 URL 格式:
https://jinshuju.net/f/TOKEN?x_field_1=$VALUE$
表单字段传参
金数据表单 表单字段传参 功能,支持在发布出去的表单上,传入多个 URL 参数。最终填表人在提交表单时,这些数据会回填到表单的对应字段上。
表单字段传参 支持对 URL 参数加签名校验,用于防止填表人篡改。
发布表单的 URL 格式:
https://jinshuju.net/f/TOKEN?field_1=$VALUE$&field_2=$VALUE$&sign=$SIGNATURE$
全局字段传参
金数据表单 全局字段传参 功能,支持在发布出去的表单上,传入多个 URL 参数。最终填表人在提交表单时,这些数据会回填到账号的全局字段上,并且回显在表单的数据页面。
全局字段传参 支持对 URL 参数加签名校验,用于防止填表人篡改。
发布表单的 URL 格式:
https://jinshuju.net/f/TOKEN?cusd=$JWT_ENCODED_DATA$
常见问题
URL中含特殊字符导致无法正常传入参数
| 特殊字符 | 在url中的含义 | 转义字符 |
|---|---|---|
| + | URL 中+号表示空格 | %2B |
| / | 分隔目录和子目录 | %2F |
| = | URL 中指定参数的值 | %3D |
| ? | 分隔实际的URL和参数 | %3F |
| 空格(space) | URL中的空格可以用+号或者编码 | %20 |
| & | URL 中指定的参数间的分隔符 | %26 |
| % | 指定特殊字符 | %25 |
| # | 表示书签 | %23 |