資料查詢API概述

1.1 應用場景

• 企業安全規範要求，不允許直連業務庫，程式碼開發API效率低，人工傳輸易出錯。

• 缺乏安全的資料共享機制，隨着資料消費端增加，IT 出現重複造輪子的傾向。

1.2 功能簡介

資料服務提供資料共享能力，可以將加工、融合後的數據封裝發佈為規範化 API API資料，供外部系統呼叫，實現資料價值匯出及共享開放。

• 當前僅支援Tomcat獨立部署FDL版本使用。

• FineDataLink 資料服務支援的資料源詳情參見：FineDataLink支援的資料源

注：推薦使用谷歌和 Edge 瀏覽器最新版本，其他瀏覽器可能會有相容問題。

• 使用 FineDataLink 的資料服務功能建立資料 API 需要註冊相關功能點，詳情參見：註冊簡介

• 非超級管理者使用者想要使用該功能需要為使用者分配 資料服務API管理權限

• 確認連結性：

  發起 API 呼叫請求時，請求會下發至資料服務的伺服器，並被進一步轉發至資料源中執行資料查詢，因此需要保證可以存取相應的資料源及其所在的網路。需要在保證網路連通的前提下，再使用資料服務；如果網路不通，會導致 API 呼叫請求無法執行。您可設定 配置API黑白名單 進行控制。

4.1 發佈 API 流程

使用 FineDataLink 資料服務進行 API 發佈的操作流程如下：

注：資料服務完整範例請參見：資料服務簡單範例

4.2 呼叫已發佈的 API 流程

1）4.0.24 及之前的版本升級 4.0.28 版本：

• 對於 API 發佈方，需要重建立立一遍已有 API，或是透過我們的客製腳本完成遷移。

• 對於呼叫方，在呼叫時由於增加了應用ID路徑，需要手動修改API的存取地址。

• 升級前若 API 設定了參數，會自動將參數值連結上單引號傳送，更新後，所見即所傳，不會自動連結單引號過去，可能會需要調整發布SQL或者傳參方式。

2）4.0.26 及之後的版本升級 4.0.28 版本：

• 對於呼叫方，在呼叫時由於增加了應用ID路徑，需要手動修改API的存取地址。

• 升級前若 API 設定了參數，會自動將參數值連結上單引號傳送，更新後，所見即所傳，不會自動連結單引號過去，可能會需要調整發布SQL或者傳參方式。

如有需要可交握帆軟技術支援，交握方式：前往「服務」，選擇「線上支援」、電話「400-811-8890」。

若使用者使用 FineDataLink 資料服務發佈的 API 由於跨域問題無法呼叫，可以修改 FineDataLink 伺服器目錄 %tomcat%.../conf/web.xml，刪除OPTIONS的配置，如下圖所示：

然後重啟工程。

注：此操作有一定的安全風險。