如何通過(guò)接口獲取婷燕飛數(shù)據(jù)

一、說(shuō)明：婷燕飛系統(tǒng)提供相關(guān)的接口，以便使用婷燕飛系統(tǒng)的公司可以自由的獲取自己公司的數(shù)據(jù)，以便與其它系統(tǒng)進(jìn)行數(shù)據(jù)集成，目前接口是免費(fèi)使用的，但是請(qǐng)求接口的時(shí)間限制在晚上，主要是考慮到不影響用戶的日常業(yè)務(wù)操作，而晚上正好服務(wù)器相對(duì)比較空閑。

為方便公司對(duì)接，我們的接口使用最簡(jiǎn)便的方法即可訪問(wèn)，無(wú)須過(guò)多的設(shè)置。

目前提供的接口(即URL地址），如下：

二、接口使用方法：

雖然系統(tǒng)提供了接口，但不是默認(rèn)就自動(dòng)開(kāi)放的，例如，A公司使用婷燕飛系統(tǒng)，A公司需要從婷燕飛系統(tǒng)獲取A公司自己的數(shù)據(jù)，則必須先由A公司婷燕飛系統(tǒng)管理登錄婷燕飛添加自己公司的接口即可。以下是相關(guān)步驟：

1、系統(tǒng)管理員進(jìn)入婷燕飛系統(tǒng)管理模塊，手動(dòng)添加要使用的接口

注：IP白名單是指請(qǐng)求接口的服務(wù)器的IP地址，如不在白名單范圍內(nèi)，不允許請(qǐng)求。

2、添加完后會(huì)在【數(shù)據(jù)接口】頁(yè)面出現(xiàn)接口地址，此時(shí)接口地址自動(dòng)帶上COMPID后面的參數(shù)，如下所示：

注1：上述地址就已自動(dòng)補(bǔ)上參數(shù)，剩余的就是自行設(shè)置開(kāi)始日期和結(jié)束日期即可，日期格式：YYYY-MM-DD，如2023-01-01

注2：如后期該接口不使用，則建議盡快刪除該接口，外部系統(tǒng)將無(wú)法訪問(wèn)，以保護(hù)公司數(shù)據(jù)的安全。

注3：公司自己的數(shù)據(jù)由公司自己決定是否開(kāi)放，因數(shù)據(jù)開(kāi)放導(dǎo)致的數(shù)據(jù)泄密等自行負(fù)責(zé)（這也就是為什么我們默認(rèn)是不開(kāi)放的，需要系統(tǒng)管理操作添加接口才可以訪問(wèn)的原因，系統(tǒng)管理員添加接口的行為即視為公司主動(dòng)開(kāi)放自己的數(shù)據(jù)給外部）

3、將上述地址復(fù)制到您的其它系統(tǒng)中請(qǐng)求它即可，所有接口地址返回JSON格式數(shù)據(jù)，請(qǐng)自行解析使用，返回的數(shù)據(jù)自行分析其內(nèi)容（一看數(shù)據(jù)便知道，如不知道，請(qǐng)系統(tǒng)管理員協(xié)助點(diǎn)開(kāi)相關(guān)的一條數(shù)據(jù)，對(duì)照內(nèi)容即可知道字段的內(nèi)容）