开发者可以自行根据以下说明及对应的说明文档,通过表单API获取表单定义、通过数据API追加数据或通过数据推送API将新提交的数据推送到自己的平台。
你可以在 「个人中心 —— API 」来开启你的 API 支持; 「系统设置 —— 企业API 」可获取企业 API 支持及 「获取 API &企业API Key/Secret」。
目前,API 访问的地址为:
https://jinshuju.net/api/v1/
https://YOUR_DOMAIN.jinshuju.com/api/v1/
如果你不清楚你应该使用哪个 API 地址,可以在网站内联系在线客服确认。
你可以通过该API获取表单定义,然后你可以在任意你熟知的平台上重绘这个表单。通过结合[数据 API],你可以脱离金数据界面绘制和添加数据,点击查看表单 API 详细说明。
你可以通过此API新增以及获取数据。你能够将所有的数据通过 JSON 格式以 HTTP POST 的方式发送到对应的表单,点击查看数据 API 详细说明。
开启数据推送 API 的表单收到新数据或者数据发送变化时,金数据会将该数据通过 HTTP POST 推送到指定的数据接收地址,点击查看数据推送 API (Webhook) 详细说明。
金数据服务器出口 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 | - | - | - | ✔️ | ✔️ | ✔️ |