HTTP

HTTP इंटीग्रेशन Macro Deck से वेब अनुरोध भेजता है। इसका उपयोग किसी वेबहुक को कॉल करने, आपके नेटवर्क में वेब 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"} पोस्ट करता है।
• एक बटन जो आपके नेटवर्क में किसी स्मार्ट प्लग को उसके लोकल वेब API से चालू करता है।
• एक बटन जो JSON मान प्राप्त करें से किसी सार्वजनिक API से मौजूदा कीमत पढ़ता है और उसे {{ vars.price }} के साथ अपने लेबल में दिखाता है।
• एक फ़्लो जो अनुरोध भेजता है, $status कैप्चर करता है और यदि / अन्यथा से बटन को लाल कर देता है जब सर्वर ने 200 से जवाब नहीं दिया।

क्वेरी पैरामीटर और हेडर के मानों में वेरिएबल हो सकते हैं, उदाहरण के लिए {{ vars.channel }}। अनुरोध उस कंप्यूटर पर चलता है जिस पर Macro Deck चलता है, इसलिए http://192.168.1.20 जैसे पते उस कंप्यूटर के नेटवर्क के डिवाइस तक पहुँचते हैं। जब सर्वर तक नहीं पहुँचा जा सकता, अनुरोध का टाइमआउट हो जाता है, TLS सर्टिफ़िकेट अस्वीकार हो जाता है या स्टेटस वह नहीं होता जिसकी आपने उम्मीद की थी, तो क्रिया एक साफ़ संदेश के साथ विफल होती है।