• 金数据 API 为具备编程能力的用户提供了极强的扩展功能。
  

• 开发者可以自行根据以下说明及对应的说明文档，通过表单API获取表单定义、通过数据API追加数据或通过数据推送API将新提交的数据推送到自己的平台。

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

API 访问规则

• 所有的数据格式为 JSON。
• 所有的数据传输编码为 UTF-8。
• 除了数据推送 API 外，所有的 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

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

2. 数据API

你可以通过此API新增以及获取数据。你能够将所有的数据通过 JSON 格式以 HTTP POST 的方式发送到对应的表单。

3. 数据推送 API (Webhook)

开启数据推送 API 的表单收到新数据或者数据发送变化时，金数据会将该数据通过 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 速率限制（按小时）：
免费版试用企业版-20000
专业版试用企业版-20000
专业增强版试用企业版-20000
企业基础版-20000
企业协作版-30000
企业高级版-50000
商业合作版-50000

常见错误码

状态码	常见原因	自查方向
400	请求方法错误	请求获取表单数据的请求方法应为GET，但是请求时写成了POST
	常见于POST新增表单数据时，字段校验不通过	字段有格式要求，例如：正则表达式、字段白名单、字段黑名单、必填等
401	key和Secre与表单token不匹配	表单创建者和API请求者账户不一致
	请求头中Authorization的填写有误	key和Secre未进行base64拼接加密
402	套餐过期	检查套餐状态
404	请求地址有误	校对请求地址写法
429	请求超速率
443	TLS版本	请使用TLS 1.1或1.2版本

⚠️ 注意： 1.批量抓取1次最多50条。

2.2021年7 月 22 日起，API 功能将调整到企业版。已使用该功能的专业版和专业增强版账号，在套餐周期内可继续使用当前 API，重置后将失效。

	免费版	专业版	专业增强版	企业基础版	企业协作版	企业高级版
推送新增数据	-	-	-	✔️	✔️	✔️
推送变更数据	-	-	-	-	✔️	✔️
修改单条数据	-	-	-	✔️	✔️	✔️
删除单条数据	-	-	-	✔️	✔️	✔️
表单API	-	-	-	✔️	✔️	✔️
数据API	-	-	-	✔️	✔️	✔️

---

👉联系技术咨询