如何通过接口获取婷燕飞数据
一、说明:婷燕飞系统提供相关的接口,以便使用婷燕飞系统的公司可以自由的获取自己公司的数据,以便与其它系统进行数据集成,目前接口是免费使用的,但是请求接口的时间限制在晚上,主要是考虑到不影响用户的日常业务操作,而晚上正好服务器相对比较空闲。
为方便公司对接,我们的接口使用最简便的方法即可访问,无须过多的设置。
目前提供的接口(即URL地址),如下:
二、接口使用方法:
虽然系统提供了接口,但不是默认就自动开放的,例如,A公司使用婷燕飞系统,A公司需要从婷燕飞系统获取A公司自己的数据,则必须先由A公司婷燕飞系统管理登录婷燕飞添加自己公司的接口即可。以下是相关步骤:
1、系统管理员进入婷燕飞系统管理模块,手动添加要使用的接口
注:IP白名单是指请求接口的服务器的IP地址,如不在白名单范围内,不允许请求。
2、添加完后会在【数据接口】页面出现接口地址,此时接口地址自动带上COMPID后面的参数,如下所示:
注1:上述地址就已自动补上参数,剩余的就是自行设置开始日期和结束日期即可,日期格式:YYYY-MM-DD,如2023-01-01
注2:如后期该接口不使用,则建议尽快删除该接口,外部系统将无法访问,以保护公司数据的安全。
注3:公司自己的数据由公司自己决定是否开放,因数据开放导致的数据泄密等自行负责(这也就是为什么我们默认是不开放的,需要系统管理操作添加接口才可以访问的原因,系统管理员添加接口的行为即视为公司主动开放自己的数据给外部)
3、将上述地址复制到您的其它系统中请求它即可,所有接口地址返回JSON格式数据,请自行解析使用,返回的数据自行分析其内容(一看数据便知道,如不知道,请系统管理员协助点开相关的一条数据,对照内容即可知道字段的内容)