Postman - Restful API 測試管理工具

發表於 更新於 分類於

內容大綱

  1. Postman 簡介
  2. 安裝下載
  3. 範例：找 OpenData 來練習 GET 方法請求

Postman 簡介

Postman 是一套用來測試 Restful API 的分類管理工具，管理上相當方便，可以整合應用程式上所有用到的 API。 HTTP API 是透過路徑做區分呼叫的方法，請求的方法有很多種，一般常見會用 GET 以及 POST，不過事實上也有更多種方法 (GET/POST/PUT/DELETE/HEAD/OPTIONS…)，可以依照需求做選擇。

安裝下載

請到 POSTMAN 網站 進入下載，下載並且安裝之後介面如下

一開始的畫面

在這個介面，左邊選單主要有 History (紀錄每一次請求) 以及 Collections (像是資料夾) 頁籤

範例：找 OpenData 來練習

在本篇範例我們找一個 高雄市政府資料開放 網站來做練習。

點擊，首頁上方的資料集

由於一般在回傳時都會使用 json 格式 (易讀) ，所以一開始進入頁面時時都會先找 JSON 格式。

在這裡找到一個 Open1999派工受理案件資料 來實作，點選第一個「Open1999派工受理案件即時600筆資料」

進入頁面之後，可以得到一個 資料下載網址 https://soweb.kcg.gov.tw/open1999/ServiceRequestsQuery.asmx/ServiceRequestsQuery?startdate=&enddate=

拿到資料含有 JSON 格式的網址之後，我們將它貼到 POSTMAN 內的 URL 欄位中，而在 Method 選項選擇 GET (從伺服器檢索資料)，資料由 URI(統一資源識別符號) 標識。確認無誤時按下 Send

可以看到下方的結果顯示一個陣列形式的結果，以這個例子來說 Open1999派工受理案件 頁面也會提供詳細的欄位說明，那麼寫程式的您就可以測得結果後，更輕易的讀取這組 URL 給的回應有哪些欄位或是錯誤訊息。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
Seq(序號)
FileNo(案號)
Cre_Date(反映日期)
Save_Date(通報日期)
ReplyUnit(權責單位代碼)
UnitName(權責單位)
Zipcode(行政區域代碼_郵政區號)
ZipName(行政區域)
Address(維修地點)
Informdesc(通報事項)
Beforedesc(反映內容)
Status(管制狀況代碼)
StatusName(管制狀況)
Close_Date(結案日期)
Afterdesc(處理結果)
Memo(備註)
Lat_(緯度)
Lng_(經度)

當您常使用這組 API 時，可以將它存在 POSTMAN 內，並且善用 Collection 做資料夾的管理，下次就不用在到網站苦苦尋找連結了。