1. 概述
1.1 版本
| FineDataLink版本 | 功能變動 |
|---|---|
| 4.0.28 | 支援使用 IN 文法實現多值查詢 |
1.2 應用場景
使用者想要在發佈 API 時，對 API 取數邏輯進行設定：使用 SQL 的 IN 語句一個參數傳入多值，對指定表的指定列做多值查詢。
2. 操作步驟
範例需要將「訂單表」中的資料發佈為 API，並在取數時可同時取出多個地區（華北、華東、華南等）的資料。
2.1 建立API
進入「資料服務」，點選「建立>API服務」，輸入API服務的名稱後，點選「確定」按鈕。如下圖所示：
2.2 設定API資訊
2.2.1 服務內容（資料查詢）
設定介面如下圖所示：
各設定項說明如下：
各設定項詳細說明請參見：發佈API概述
設定項 | 說明 |
SQL語句 | 範例為 MySQL 資料庫文法，不同資料庫的文法不同，使用者可根據實際使用資料庫類型修改文法 |
分頁查詢 | 關閉「分頁查詢」按鈕，呼叫生成的 API 後傳回資料不進行分頁 |
自訂參數 | 為自訂參數「貨主地區」除錯值寫入華東','華北，可查詢「貨主地區」為華東、華北的資料 |
2.2.2 APIAPI配置
1）請求方式選擇 POST；路徑設定為 demo（支援自訂） 。
新增應用，若此時沒有建立應用，可不新增應用，在完成 API 建立後，在應用列表中綁定 API ，詳情參見：綁定API至應用；綁定應用步驟必做，否則後續無法呼叫該 API 。
請求 Body 格式設定為 application/json。如下圖所示：
各設定項詳細說明請參見：發佈API概述
2）點選右下角的「測試呼叫」按鈕，可除錯 API；「貨主地區」參數值預設為除錯值：華東','華北，傳回多值查詢內容。如下圖所示：
3）點選「儲存聯集線」按鈕，即可成功建立聯集線服務API。如下圖所示：