金数据 API 介绍

  • 金数据 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

表单API

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

数据API

你可以通过此API新增以及获取数据。你能够将所有的数据通过 JSON 格式以 HTTP POST 的方式发送到对应的表单,点击查看数据 API 详细说明

数据推送 API (Webhook)

开启数据推送 API 的表单收到新数据或者数据发送变化时,金数据会将该数据通过 HTTP POST 推送到指定的数据接收地址,点击查看数据推送 API (Webhook) 详细说明

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 速率限制(按小时):
免费版试用企业版-20,000
专业版试用企业版-20,000
专业增强版试用企业版-20,000
企业基础版-20,000
企业协作版-30,000
企业高级版-50,000
商业合作版-50,000

常见错误码

状态码 常见原因 自查方向
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 ,重置后将失效。


资费介绍

免费版 专业版 专业增强版 企业基础版 企业协作版 企业高级版
价格 免费 599 元/年 2,399 元/年,299 元/月 4,399 元/年 7,399 元/年 23,999 元/年
Webhook 推送新增数据 - ✔️ ✔️ ✔️ ✔️ ✔️
Webhook 推送变更数据 - - - - ✔️ ✔️
修改单条数据 - - - ✔️ ✔️ ✔️
删除单条数据 - - - ✔️ ✔️ ✔️
表单API - - - ✔️ ✔️ ✔️
数据API - - - ✔️ ✔️ ✔️

👉联系技术咨询

联系客服