HTTP

L'integrazione HTTP invia richieste web da Macro Deck. Usala per chiamare un webhook, controllare un dispositivo della tua rete che ha un'API web o leggere un valore da un servizio online e mostrarlo su un pulsante. È inclusa in Macro Deck ed è attiva fin dall'inizio, quindi non c'è niente da collegare e nessun accesso da fare.

Due azioni

Invia richiesta HTTP compone una richiesta completa. Scegli il Metodo, inserisci l'URL e aggiungi Parametri di query e Intestazioni come coppie nome e valore. In Tipo di corpo scegli none, json, form, text o multipart (un caricamento di file con campi del modulo aggiuntivi). Autenticazione offre basic (nome utente e password), bearer (un token) e header (un token in un'intestazione di cui indichi il nome, per esempio X-Api-Key). Stato previsto stabilisce quali risposte contano come riuscite, 2xx per impostazione predefinita. Puoi anche impostare il Timeout, disattivare Segui i reindirizzamenti e limitare la Dimensione massima risposta (byte).

Acquisizioni salva parti della risposta in variabili. Ogni riga abbina il nome di una variabile a un selettore: $status, $ok, $duration, $body, $truncated, $headers, $header:<name> o un percorso JSON come data.items[0].name. Una variabile che non esiste ancora viene creata.

Ottieni valore JSON è la forma breve per leggere un solo valore: inserisci l'URL, un Percorso JSON e la variabile in Salva in variabile.

Esempi di configurazione

• Un pulsante che invia {"text": "Stream is live"} al webhook di una chat con Invia richiesta HTTP e tipo di corpo json.
• Un pulsante che accende una presa smart della tua rete tramite la sua API web locale.
• Un pulsante che legge il prezzo attuale da un'API pubblica con Ottieni valore JSON e lo mostra nella sua etichetta con {{ vars.price }}.
• Un flusso che invia una richiesta, acquisisce $status e usa Se / Altrimenti per colorare di rosso il pulsante quando il server non ha risposto con 200.

I valori dei parametri di query e delle intestazioni possono contenere variabili, per esempio {{ vars.channel }}. La richiesta parte dal computer su cui gira Macro Deck, quindi indirizzi come http://192.168.1.20 raggiungono i dispositivi della rete di quel computer. Un'azione non riesce con un messaggio chiaro quando il server non è raggiungibile, la richiesta va in timeout, il certificato TLS viene rifiutato o lo stato non è quello previsto.