在「捷徑」中要求第一個 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
,也就是舊金山阿爾卡特拉斯島的座標。(您可以將這些值更改為其他位置。)嘗試使用「取得目前位置」動作,並將其做為設為「緯度」和「經度」的「神奇變數」置於 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。