HTTP

HTTP 整合可從 Macro Deck 傳送網路請求。可用來呼叫 Webhook、控制網路中具有 Web API 的裝置，或從線上服務讀取值並顯示在按鈕上。它隨 Macro Deck 一同提供，預設已啟用，不需要連線或登入任何服務。

兩個動作

傳送 HTTP 請求 可建立完整的請求。選擇 方法，輸入 URL，並以名稱和值的配對加入 查詢參數 和 標頭。在 內文類型 下可選擇 none、json、form、text 或 multipart（含額外表單欄位的檔案上傳）。驗證 提供 basic（使用者名稱和密碼）、bearer（權杖）和 header（放在自訂名稱標頭中的權杖，例如 X-Api-Key）。預期狀態 決定哪些回應視為成功，預設為 2xx。也可以設定 逾時、關閉 跟隨重新導向，以及限制 回應大小上限（位元組）。

擷取 會將回應的部分內容儲存到變數。每一行將一個變數名稱與一個選擇器配對：$status、$ok、$duration、$body、$truncated、$headers、$header:<name>，或 data.items[0].name 之類的 JSON 路徑。尚不存在的變數會自動建立。

取得 JSON 值 是讀取單一值的簡便方式：輸入 URL、JSON 路徑，並在 儲存至變數 下選擇變數。

設定範例

• 一個按鈕使用 傳送 HTTP 請求 和內文類型 json，將 {"text": "Stream is live"} 傳送到聊天 Webhook。
• 一個按鈕透過網路中智慧插座的本機 Web API 開啟插座。
• 一個按鈕使用 取得 JSON 值 從公開 API 讀取目前價格，並用 {{ vars.price }} 顯示在標籤中。
• 一個流程傳送請求、擷取 $status，並在伺服器沒有回應 200 時用 若 / 否則 將按鈕變成紅色。

查詢參數和標頭的值中可以包含變數，例如 {{ vars.channel }}。請求會在執行 Macro Deck 的電腦上執行，因此 http://192.168.1.20 之類的位址可以連到該電腦所在網路中的裝置。當伺服器無法連線、請求逾時、TLS 憑證遭拒或狀態與預期不符時，動作會失敗並顯示清楚的訊息。