HTTP

De integratie HTTP verstuurt webverzoeken vanuit Macro Deck. Gebruik haar om een webhook aan te roepen, een apparaat in je netwerk met een web-API te bedienen, of een waarde uit een online dienst te lezen en op een knop te tonen. Ze wordt met Macro Deck meegeleverd en staat vanaf het begin aan, dus je hoeft niets te verbinden en je nergens aan te melden.

Twee acties

HTTP-verzoek versturen stelt een volledig verzoek samen. Je kiest de Methode, vult de URL in en voegt Queryparameters en Headers toe als paren van naam en waarde. Onder Bodytype kies je none, json, form, text of multipart (een bestandsupload met extra formuliervelden). Authenticatie biedt basic (gebruikersnaam en wachtwoord), bearer (een token) en header (een token in een header die je zelf een naam geeft, bijvoorbeeld X-Api-Key). Verwachte status bepaalt welke antwoorden als geslaagd gelden, standaard 2xx. Je kunt ook de Time-out instellen, Redirects volgen uitzetten en de Max. grootte van respons (bytes) beperken.

Vastleggingen slaan delen van de respons op in variabelen. Elke regel koppelt een variabelenaam aan een selector: $status, $ok, $duration, $body, $truncated, $headers, $header:<name> of een JSON-pad zoals data.items[0].name. Een variabele die nog niet bestaat, wordt aangemaakt.

JSON-waarde ophalen is de korte vorm om één waarde te lezen: vul de URL, een JSON-pad en de variabele onder Opslaan in variabele in.

Voorbeelden

• Een knop die met HTTP-verzoek versturen en bodytype json het bericht {"text": "Stream is live"} naar een chatwebhook stuurt.
• Een knop die een slimme stekker in je netwerk aanzet via de lokale web-API.
• Een knop die met JSON-waarde ophalen de actuele prijs uit een openbare API leest en die in het label toont met {{ vars.price }}.
• Een actiestroom die een verzoek verstuurt, $status vastlegt en met Als / Anders de knop rood kleurt als de server niet met 200 antwoordde.

De waarden van queryparameters en headers kunnen variabelen bevatten, bijvoorbeeld {{ vars.channel }}. Het verzoek wordt uitgevoerd op de computer waarop Macro Deck draait, dus adressen zoals http://192.168.1.20 bereiken apparaten in het netwerk van die computer. Een actie mislukt met een duidelijke melding als de server niet bereikbaar is, het verzoek een time-out krijgt, het TLS-certificaat wordt geweigerd of de status niet de verwachte is.