经常有用户问:我怎么把金数据收集来的数据导入我公司的IT系统里?
对于以上问题,金数据提供了三种与外部系统对接的方式,用户可以根据自己的需求和开发能力,选择最适合的方式。
简单方式,用户的IT系统被动接收数据:配置数据推送(webhook)
在表单设置中配置webhook地址,这是你的IT系统服务器暴露出来的一个api接口。当该表单有新数据提交的时候,金数据服务器会发送一个post请求到配置的地址,将新增数据的数据内容推送到你的服务器。数据中各个字段的值都是格式化好的,你的服务器接收并处理这些数据,并返回成功状态即可。
如果你的企业想要接收所有表单的数据,那么请企业管理员在企业设置里配置webhook就好。
进阶方式,主动从金数据拿数据:API
金数据向开发者提供了两组API,分别为v1版本和v4版本。v1版本对所有企业版用户都开放,而v4版本目前仅对金数据商业合作伙伴开放。
v1版本获取数据的接口地址为 https://YOUR_DOMAIN.jinshuju.com/api/v1/forms/FORM_ID/entries,接受一个GET请求。你可以到金数据平台的个人中心中自助开启API访问的能力,此时系统会为你分配API Key和API Secret。使用这对API Key和Secret用HTTP Basic方式验证发起获取数据的请求,可以拿到指定表单下的所有数据。如果数据量超过50条,那么你可以根据请求结果中的next参数拿到另50条数据的链接,继续请求另50条数据。
除了获取数据,v1版本还能获取表单结构和提交数据。表单结构+数据提交+数据列表,已能满足大部分用户的对接需求。
v4版本获取数据的接口地址为 https://api.jinshuju.com/v4/forms/FORM_ID/entries?access_token=...,同样为GET请求。要开通v4版本API,你需要联系金数据客服,并提供你的授权回调地址。金数据平台会根据你提供的资料为你的企业创建一个金数据应用,并分配一组client id和client secret。你拿到client id后,可以使用标准的OAuth交互协议进行访问。个人授权或企业授权后获得access_token,然后就可以用这个access_token获取数据了。
v4版本获取的数据跟v1的不同,你需要结合表单结构的API才能拿到数据的显示值。比如数据请求结果中拿到单选字段「年龄段」的值为EtdU,再结合表单结构请求结果,才能知道数据中的「年龄段」的显示值为「20 - 30岁」。
你可能会说,v4版本怎么这么复杂。v4版本的目标用户为有较强开发能力的商业合作伙伴,通过v4灵活的api,用户可以重绘表单、更新部分表单设置、重绘数据列表、并能对数据列表进行筛选过滤。如果是企业授权,还能获得企业中的所有用户及表单。
你现在已经大致了解了金数据如何与你的IT系统对接,如果需要更详细的API文档,可以访问帮助中心或直接联系我们。快些让数据流到你的系统里吧!