目標
一、建立環境(Environment)
在 Postman 建立一個新的 Environment 並加入以下變數:
• baseUrl_routes :固定資料的基底網址
• baseUrl_eta :即時到站的基底網址
• apiKey :若需要金鑰,放在這裡;無則留空
範例 JSON(可匯入或手動新增)
{
"name": "Taipei-Transport",
"values": [
{"key": "baseUrl_routes", "value": "", "type": "text", "enabled": true},
{"key": "baseUrl_eta", "value": "", "type": "text", "enabled": true},
{"key": "apiKey", "value": "", "type": "text", "enabled": true}
]
}
二、建立 Collection 與資料夾
• 建立 Collection:Taipei-Transport
• 在 Collection 內建立兩個資料夾:Fixed(站/路線)/Realtime(到站)
三、請求一:站/路線(固定資料)
• 方法:GET
• 網址:{{baseUrl_routes}}/...(依官方說明頁填入實際路徑)
• 必要參數:依說明頁填入;若有城市或分頁參數,一併加入 Params
• Headers:若需要金鑰,新增 Authorization 或對應欄位,值可用 {{apiKey}}
成功畫面預期:Status 200,回應中可見路線名稱/編號、站名/站點編號、經緯度、站序等欄位。
四、請求二:到站(即時資料)
• 方法:GET
• 網址:{{baseUrl_eta}}/...(依官方說明頁填入實際路徑)
• 必要參數:路線編號、站點編號(若需要方向一併加入),放在 Params
• Headers:若需要金鑰,新增 Authorization 或對應欄位,值可用 {{apiKey}}
成功畫面預期:Status 200,回應中可見路線編號、站點編號、預估到站時間(秒或分)、狀態、更新時間等欄位。
五、保存與輸出
• 將 Collection 命名為「Taipei-Transport」並保存。
結果摘要:
• 站/路線請求:成功,回應包含路線名稱/編號、站名/站點編號、經緯度、站序。
• 到站請求:成功,回應包含路線編號、站點編號、預估到站時間、狀態、更新時間。
• 兩支請求均以 Environment 變數管理基底網址與金鑰。