HTTP

Integrace HTTP posílá z Macro Deck webové požadavky. Použijte ji k volání webhooku, ovládání zařízení s webovým API ve vaší síti nebo k načtení hodnoty z online služby a jejímu zobrazení na tlačítku. Je součástí Macro Deck a od začátku zapnutá, takže se nemusíte nikam připojovat ani přihlašovat.

Dvě akce

Odeslat HTTP požadavek sestaví úplný požadavek. V poli Metoda zvolíte metodu, zadáte URL a v polích Parametry dotazu a Hlavičky přidáte dvojice název a hodnota. V části Typ těla požadavku vyberete none, json, form, text nebo multipart (nahrání souboru s dalšími poli formuláře). Ověřování nabízí basic (uživatelské jméno a heslo), bearer (token) a header (token v hlavičce, kterou pojmenujete, například X-Api-Key). Očekávaný stav určuje, které odpovědi se považují za úspěch, ve výchozím stavu 2xx. Můžete také nastavit Časový limit, vypnout Sledovat přesměrování a omezit velikost odpovědi v poli Maximální velikost odpovědi (bajty).

Zachycené hodnoty ukládají části odpovědi do proměnných. Každý řádek páruje název proměnné se selektorem: $status, $ok, $duration, $body, $truncated, $headers, $header:<name> nebo cesta JSON, například data.items[0].name. Proměnná, která ještě neexistuje, se vytvoří.

Získat hodnotu JSON je zkrácená forma pro načtení jedné hodnoty: zadejte URL, vyplňte Cesta JSON a v poli Uložit do proměnné zvolte proměnnou.

Příklady použití

• Tlačítko, které pomocí Odeslat HTTP požadavek s typem těla json pošle {"text": "Stream is live"} do webhooku chatu.
• Tlačítko, které zapne chytrou zásuvku ve vaší síti přes její lokální webové API.
• Tlačítko, které pomocí Získat hodnotu JSON načte aktuální cenu z veřejného API a zobrazí ji v popisku pomocí {{ vars.price }}.
• Postup, který pošle požadavek, zachytí $status a pomocí Když / Jinak obarví tlačítko červeně, když server neodpověděl s 200.

Hodnoty parametrů dotazu a hlaviček můžou obsahovat proměnné, například {{ vars.channel }}. Požadavek se provádí na počítači, na kterém běží Macro Deck, takže adresy jako http://192.168.1.20 vedou na zařízení v síti tohoto počítače. Akce selže se srozumitelnou zprávou, když server není dostupný, vyprší časový limit požadavku, certifikát TLS je odmítnut nebo stav neodpovídá očekávanému.