HTTP

HTTP entegrasyonu Macro Deck’ten web istekleri gönderir. Bir webhook’u çağırmak, ağınızda web API’si olan bir cihazı kontrol etmek veya çevrimiçi bir hizmetten bir değer okuyup bir düğmede göstermek için kullanın. Macro Deck ile birlikte gelir ve baştan açıktır; bağlanacak veya oturum açılacak bir şey yoktur.

İki eylem

HTTP isteği gönder eksiksiz bir istek oluşturur. Yöntem seçersiniz, URL girersiniz ve ad ile değer çiftleri olarak Sorgu parametreleri ve Üstbilgiler eklersiniz. Gövde türü altında none, json, form, text veya multipart (ek form alanlarıyla bir dosya yükleme) seçersiniz. Kimlik doğrulama basic (kullanıcı adı ve parola), bearer (bir belirteç) ve header (adını sizin verdiğiniz bir üstbilgide belirteç, örneğin X-Api-Key) seçeneklerini sunar. Beklenen durum hangi yanıtların başarılı sayılacağını belirler, varsayılan olarak 2xx. Ayrıca Zaman aşımı ayarlayabilir, Yönlendirmeleri izle seçeneğini kapatabilir ve En büyük yanıt boyutu (bayt) değerini sınırlayabilirsiniz.

Yakalamalar yanıtın bölümlerini değişkenlere kaydeder. Her satır bir değişken adını bir seçiciyle eşleştirir: $status, $ok, $duration, $body, $truncated, $headers, $header:<name> veya data.items[0].name gibi bir JSON yolu. Henüz var olmayan bir değişken oluşturulur.

JSON değerini al tek bir değeri okumanın kısa yoludur: URL, bir JSON yolu ve Değişkene kaydet altında değişkeni girin.

Örnek kurulumlar

• HTTP isteği gönder ve json gövde türüyle bir sohbet webhook’una {"text": "Stream is live"} gönderen bir düğme.
• Ağınızdaki bir akıllı prizi yerel web API’si üzerinden açan bir düğme.
• JSON değerini al ile herkese açık bir API’den güncel fiyatı okuyan ve {{ vars.price }} ile etiketinde gösteren bir düğme.
• Bir istek gönderen, $status değerini yakalayan ve sunucu 200 ile yanıt vermediğinde düğmeyi kırmızıya boyamak için Eğer / Yoksa kullanan bir akış.

Sorgu parametrelerinin ve üstbilgilerin değerleri değişken içerebilir, örneğin {{ vars.channel }}. İstek Macro Deck’in çalıştığı bilgisayarda çalışır; bu nedenle http://192.168.1.20 gibi adresler o bilgisayarın ağındaki cihazlara ulaşır. Sunucuya ulaşılamadığında, istek zaman aşımına uğradığında, TLS sertifikası reddedildiğinde veya durum beklediğiniz gibi olmadığında eylem açık bir mesajla başarısız olur.