金数据 API 介绍

	免费版	专业版	专业增强版	企业基础版	企业协作版	企业高级版
推送新增数据	✘	✔️	✔️	✔️	✔️	✔️
推送变更数据	✘	✘	✘	✘	✔️	✔️
表单API	✔️	✔️	✔️	✔️	✔️	✔️
数据API	✔️	✔️	✔️	✔️	✔️	✔️

金数据 API 为具备编程能力的用户提供了极强的扩展功能。
开发者可以自行根据以下说明及对应的说明文档，通过表单API获取表单定义、通过数据API追加数据或通过数据推送API将新提交的数据推送到自己的平台。

您可以在 个人中心 —— API 来开启您的API支持；系统设置 —— 企业API可获取企业API支持及获取 API &企业API Key/Secret。

API 访问规则

• 所有的数据格式为 JSON
• 所有的数据传输编码为 UTF-8
• 除了数据推送 AP I外，所有的 API 都需要恰当的 API 访问权限。目前我们仅支持 HTTP Basic Auth 验证的方式。

API 访问地址

目前，API 访问的地址为

• jinshuju.net 包含位于 jinshuju.net 上的免费版/付费版/企业套餐

https://jinshuju.net/api/v1/ 

• jinshuju.com 包含位于 jinshuju.com 上的企业套餐

https://YOUR_DOMAIN.jinshuju.com/api/v1/

如果您不清楚您应该使用哪个 API 地址，可以在网站内联系在线客服确认

目前提供的 API

1. 数据推送 API (Webhook)
   开启数据推送 API 的表单收到新数据或者数据发送变化时，金数据会将该数据通过 HTTP POST 推送到指定的 URL。

2. 表单 API
   您可以通过该 AP I获取表单定义，然后你可以在任意你熟知的平台上重绘这个表单。通过结合数据 API，您可以脱离金数据界面绘制和添加数据。

3. 数据 API
   您可以通过这个 API 添加数据。您能够将所有的数据通过 JSON 格式以 HTTP POST 的方式发送到对应的表单。

Outboard IP List

金数据服务器出口 IP 列表。如果您对接的服务器有 IP 白名单限制，请将以下对应 IP 地址加入白名单中。

jinshuju.net 

52.82.74.116  
52.82.89.22  
52.82.100.17  
54.223.160.170 (2019年6月19日0时弃用)  
54.223.152.10 (2019年6月19日0时弃用)   

jinshuju.com 

52.82.114.21  
52.83.140.104  
52.83.245.251  
54.223.74.252 (2019年6月20日0时弃用)  
54.223.17.54 (2019年6月20日0时弃用)

API：v1和v4 rate limit （按小时）：

免费版-20000
专业版-20000
专业增强版-20000
企业基础版-20000
企业协作版-30000
企业高级版-50000
商业合作版-50000