金数据对外接口文档

金数据开放平台，提供了强大灵活的系统集成能力。你可以将你的系统或者第三方系统，与金数据链接起来，实现更为强大的系统综合应用。

开放中心文档：https://open.jinshuju.net/#/

目前金数据开放平台提供的能力包括：

API (v1)

API 已向所有账户开放，使用者可以通过 API 获取表单信息和数据信息，也可以创建或修改数据。任意套餐的账户都可以用自己的账号认证；企业基础版及以上套餐还支持企业全局认证。

不同套餐的 API 调用额度如下：

API v1 的认证方式

API v1 使用 Access Token 认证，通过请求头 Authorization: Bearer ACCESS_TOKEN 传递。2026 年 9 月 3 日起，新版认证方式（Access Token）与旧版认证方式（API Key/Secret）同时存在：

• 此前已经生成过 API Key/Secret 的账户，Key/Secret 继续保留，正在运行的集成不受影响；
• 此前没有生成过 API Key/Secret 的账户，「个人 API」中不再显示 API Key/Secret，请直接创建 Access Token；
• 旧版 API Key/Secret 已不推荐使用，后续会下线，建议已有集成尽早迁移到 Access Token。

两种 Access Token 的套餐支持情况如下：

创建个人 Access Token

个人 Access Token 的权限范围与该账号在后台看到的一致：可以访问该账号创建的表单、以及被共享给该账号的表单及其数据。

1. PC 端登录金数据账号，点击右上角头像，进入「个人中心」→「个人 API」。
2. 在「个人 Access Token」中点击「创建 Token」，填写名称。
3. 复制并保存生成的 Access Token。Access Token 只在创建时完整显示一次，关闭弹窗后无法再次查看。

创建企业 Access Token

企业 Access Token 可以访问整个企业的所有表单和数据，仅企业基础版及以上套餐支持，且需要由企业管理员创建。

1. 企业管理员在 PC 端登录金数据账号，点击右上角头像，进入「系统设置」→「企业 API」。
2. 在「企业 Access Token」中点击「创建 Token」，填写名称。
3. 复制并保存生成的 Access Token，同样只在创建时显示一次。

撤销 Access Token

在创建 Access Token 的同一位置，点击 Access Token 右侧的删除图标即可撤销不再使用的 Access Token。撤销后该 Access Token 立即失效，正在使用它的集成会因此中断，且无法恢复。

请求头怎么设置

调用 API 时需要设置以下请求头：

Content-Type: application/json
Accept: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

完整的认证说明，以及 curl、Postman、Java、Python、Ruby 的示例代码，见开放平台的 API v1 认证方式 文档。

Webhook

专业版（含）以上套餐支持使用 Webhook 提供了数据推送能力。当表单收集到新的数据，或者数据发生变更时，金数据主动推送数据到你的服务器。

URL 传参

企业高级版套餐，可以向填表人推送表单链接时，可以在 URL 上传入数据，这些数据会被自动获取到最终金数据的表单数据上。