最新历史版本 :發佈API-多值查詢 返回文檔
編輯時間: 內容長度:图片数:目录数: 修改原因:
icon提示:
本文方案适用于 4.2.6.2 及之后版本;4.0.28 之前版本,请参见:历史文档;4.0.28-4.2.6.2 版本,请参见:历史文档

目錄:

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 服務內容(資料查詢)

設定介面如下圖所示:

SELECT * FROM `demotest`.`訂單資訊` WHERE 貨主地區 IN ('${貨主地區}')

各設定項說明如下:

各設定項詳細說明請參見:發佈API概述

設定項

說明

SQL語句

範例為 MySQL 資料庫文法,不同資料庫的文法不同,使用者可根據實際使用資料庫類型修改文法

分頁查詢

關閉「分頁查詢」按鈕,呼叫生成的 API 後傳回資料不進行分頁

自訂參數

為自訂參數貨主地區除錯值寫入華東','華北,可查詢「貨主地區」為華東、華北的資料

2.2.2 APIAPI配置

1)請求方式選擇 POST;路徑設定為 demo(支援自訂) 。

新增應用,若此時沒有建立應用,可不新增應用,在完成 API 建立後,在應用列表中綁定 API ,詳情參見:綁定API至應用綁定應用步驟必做,否則後續無法呼叫該 API 

請求 Body 格式設定為 application/json。如下圖所示:

各設定項詳細說明請參見:發佈API概述

2)點選右下角的「測試呼叫」按鈕,可除錯 API;「貨主地區」參數值預設為除錯值:華東','華北,傳回多值查詢內容。如下圖所示:

3)點選儲存聯集線按鈕,即可成功建立聯集線服務API。如下圖所示:

3. 後續步驟编辑

若使用者在發佈時沒有將 API 新增至指定應用,也可以在 綁定API至應用 中將上線的 API 透過應用進行管理,以便能夠被呼叫。

若需要使用已經發布的API,詳情參見:使用發佈的API,呼叫效果如下圖所示:

對已經發布的API進行管理,詳情參見:服務維運