最新历史版本 :發佈API-查詢NULL值資料 返回文檔
編輯時間: 內容長度:图片数:目录数: 修改原因:
icon提示:
本文方案適用於 4.2.6.2 及之後版本;4.0.28 之前版本,請參見:歷史文檔4.0.28-4.2.6.2 版本,請參見:歷史文檔

目錄:

1. 概述编辑

1.1 版本

FineDataLink版本
功能變動
4.0.28

資料發佈 API 參數支援傳入 NULL 值

1.2 應用場景

使用者想要在發佈 API 時,對 API 取數邏輯進行設定:取出發佈的 API 中為 NULL 的資料,同時也能正常查詢其他資料。

FineDataLink 支援 API 參數傳入 NULL 值。

29.png

2. 操作步驟编辑

本文範例:將「訂單表」中的資料發佈為 API,並在取數時可取出貨主省份為 NULL 值的資料,同時也能正常查詢其他資料。

2.1 建立API

進入「資料服務」,建立 API 。如下圖所示:

27.png

2.2 輸入API資訊

1)輸入 API 名稱,API 描述可為空,本文範例中請求方式選擇 post,請求 Body 格式選擇 application/json ,設定路徑,將建立的 API 新增至應用中。如下圖所示:

當然若此時沒有建立應用,可不新增應用,在完成 API 建立後,在應用列表中綁定 API ,詳情參見:綁定API至應用

注:API 的路徑、請求Body格式等基本資訊詳情參見:發佈API

20.png

2)點選「下一步」按鈕。

2.3 設定發佈內容及參數

1)選擇要發佈的資料源以及資料連結,然後輸入查詢 SQL 語句;請求參數配置中,「參數必填」按鈕關閉,即參數可以為空,參數預設值為 NULL。

SELECT * FROM `demotest`.`訂單表` WHERE IF('${province}'='NULL',貨主省份 IS NULL,貨主省份 ='${province}')

該參數在 API 發佈後,可在透過 API 取數時使用 SQL 語句設定的參數進行條件取數。

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

注2:該步驟中,各設定項介紹請參見:發佈API概述

23.png

2)點選「獲取」按鈕,輸入 NULL,可查詢貨主省份為空的資料。如下圖所示:

1712734750577018.png

輸入「北京」,可查詢貨主省份為北京的資料。

3)點選下一步

2.4 預覽測試

1)進入預覽測試步驟中,可在 Body 中填入參數值,如下圖所示:

1712735006318228.png

點選測試呼叫按鈕,即可看到測試API傳回結果。如下圖所示:

26.png

2)點選「生成API」即可完成 API 生成。如下圖所示:

28.png

2.5 API上線

右上角點選「上線」,即可發佈 API,如下圖所示:

28.png

3. 後續步驟编辑

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

若需要使用已經發布的 API,詳情參見:使用資料服務發佈的API(POST application/json請求)

可看到取出參數為 NULL 值的資料,如下圖所示:

29.png

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