使用資料服務發布的API（POST x-www-form-urlencoded請求）

本文介紹如何將 FineDataLink 資料服務發布API 中請求方式為 POST（x-www-form-urlencoded）類型的API資料取出。

注：若使用者需要使用自己系統中的 API 進行取數，可參見：API取數概述

已經發布的 API API說明如下：

請求說明：

POST 請求body參數：

請求範例：

注：此處的 area 為 發佈API  中設定的自訂參數。

回傳值參數：

回應值範例：

3.1 獲取API地址

首先在 API 列表介面選擇需要使用的 API，然後在已授權應用處複制路徑，獲取到 API 完整路徑地址，例如：http://localhost:8068/webroot/service/publish/a73a7179-20b8-40db-a4e5-15f10d75ff67/wendang，如下圖所示：

3.2 獲取 API 鑒權

若使用者使用了鑒權，則需要在「應用」中複制 APPCode，如下圖所示：

注：如果開啟了黑白名單，需要保證使用 API 的環境與發布 API 環境之間資訊能互通。

3.3 設定 API 基本資訊

使用任意取數軟體，選擇 POST 請求方式，輸入複制的 API 連結，選擇「Authorization」，勾選認證類型為「API Key」，輸入 Key：Authorization，value：本文 3.2 節複制的值，選擇 Add to 為 Header，如下圖所示：

注1：複制的連結預設為IP:埠/webroot 路徑，如果使用者的 FineDataLink 做過Tomcat下透過IP直接存取非容器化工程，則需要給複制的 url 去掉 webroot 。

注2：參數值格式為：APPCode+空格+APPCode 值，此處的 APPCode 為範例。

然後在 Body 中選擇「x-www-form-urlencoded」，輸入鍵值資料，如下圖所示：

範例取出「華北」的資料，因此自訂參數貨主地區的 value 直接寫成華北，將 pageSize 設定為 20，也就是每頁資料限制為 20 條，從第一個開始取數，查看回傳值中，每頁 20 筆資料計算總頁數為多少。

點選 send 後回傳值。如下圖所示：

呼叫回傳值說明詳情參見：資料服務錯誤程式碼表