在「捷徑」中要求第一個 API
如果要要求第一個 API,你需製作指向你想通訊的 API「端點」之 URL,然後傳送該 URL 給「取得 URL 內容」動作。捷徑執行時,此動作會發出 API 要求。
建立 API 要求
Dark Sky 的 Forecast 端點所需的 URL 要求格式如下:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
括號中的文字會填入 API 密鑰及你要求預報資料的地點。
在「捷徑」App 中,將你的 Dark Sky API 密鑰置於第一個「文字」動作裏,系統會以變數來將此密鑰傳送到 URL 動作中。
LAT
及LONG
已設為37.8267
及-122.4233</g,也
就是三藩市阿爾卡特拉斯島的座標。(你可以更改那些值到不同位置。)嘗試使用「取得目前位置」動作,並將其作為設為「緯度」及「經度」的「神奇變數」置於 URL 動作中,以便在你執行捷徑時取得當地天氣資料。
使用「取得 URL 內容」動作執行 API 要求
在「捷徑」App 的捷徑編輯器中,將「取得 URL 內容」設為「進階」。
以下你可發出的 API 要求類型選項會變為可用:
GET
可用來從 API 取得資料來讀取。POST
可用來製作新資料。PUT
及PATCH
可用來分別以取代或修改方式更新資料。DELETE
可用來移除 URL 要求中指定的物件。
在此範例中,使用
GET
要求來從 Dark Sky API 擷取資料。現在 URL 動作已具有你的要求,而且「取得 URL 內容」動作已設為
GET
資料,表示你已準備好發出 API 要求。附註:當「取得 URL 內容」動作切換為
POST
、PUT
或PATCH
時,會加入新參數「要求內文」。「要求內文」可用來將 JSON、表單或檔案作為要求的一部份傳送至 API。這讓你可手動或使用變數輸入新資料,因此你可傳送資料至 API 以製作、取代或修改項目。點一下 來測試捷徑(你可使用捷徑中的「快速查看」動作來預覽 API 傳回的資料)。
恭喜!你已使用「捷徑」發出了你的第一個 API 要求。
看第一眼時,API 似乎傳回了大量格式怪異的文字。如果仔細查看,你會發現文字中包括了天氣預報資料。這些天氣資料是以 JSON(全名為 JavaScript 物件標記法)編碼。
如需了解如何使用 JSON 及繼續操作 Dark Sky API 範例,請參閱:關於在「捷徑」中使用 JSON。