
在 Mac 上的「捷徑」中要求第一個 API
若要要求第一個 API,你製作指向你想通訊的 API「端點」之 URL,然後傳送該 URL 給「取得 URL 內容」動作。捷徑執行時,此動作會發出 API 要求。

建立 API 要求
Typicode 的端點所需的 URL 要求格式如下:
https://jsonplaceholder.typicode.com/[RESOURCE]
括號中的文字為你想取用的資源。Typicode 提供許多用於測試要求的不同範例。本範例使用 https://jsonplaceholder.typicode.com/users 來要求使用者列表。
在 Mac 上的「捷徑」App
中,將要求加入 URL。users要求會傳回使用者列表。你可以依照 ID 指定特定使用者來縮小搜尋範圍:
https://jsonplaceholder.typicode.com/users/6。這會傳回 ID 為 6 的使用者。大部分 API 都允許查詢使用下列格式:
https://jsonplaceholder.typicode.com/users?username=Bret。「?」為查詢的開頭,該查詢使用鍵值對來搜尋項目。在此範例中,?username=Bret會搜尋使用者名稱為 Bret 的使用者。請查看 API 的文件以了解支援的搜尋和查詢。
使用「取得 URL 內容」動作執行 API 要求
在 Mac 上的「捷徑」App
中,在「取得 URL 內容」動作中按一下「顯示更多」。以下你可發出的 API 要求類型選項會變為可用:
GET可用來擷取資料。POST可用來製作新資料。PUT可用來藉由取代資料的方式來更新資料。PATCH可用來藉由修改資料的方式來更新資料。DELETE可用來移除 URL 要求中指定的物件。
在此範例中,使用
GET要求來從 Typicode API 擷取資料。現在 URL 動作已具有你的要求,且「取得 URL 內容」動作已設為
GET資料,表示你已準備好發出 API 要求。【注意】當「取得 URL 內容」動作切換為
POST、PUT或PATCH時,會加入新參數「要求內文」。「要求內文」可用來將 JSON、表單或檔案做為要求的一部分傳送至 API。這讓你可手動或使用變數輸入新資料,因此可傳送資料至 API 以製作、取代或修改項目。若要測試捷徑,請按一下
。
看第一眼時,API 似乎傳回了雜亂無章的文字。此資料是以 JSON(全名為 JavaScript 物件標記法)編碼。
如需瞭解如何使用 JSON 和繼續操作 Typicode API 範例,請參閱:Mac 上「捷徑」中的使用 JSON 簡介。