HTTP

Integrasi HTTP mengirim permintaan web dari Macro Deck. Gunakan untuk memanggil webhook, mengendalikan perangkat di jaringan Anda yang memiliki API web, atau membaca nilai dari layanan online dan menampilkannya di tombol. Integrasi ini disertakan dengan Macro Deck dan sudah aktif sejak awal, jadi tidak ada yang perlu dihubungkan dan tidak perlu masuk ke akun apa pun.

Dua aksi

Kirim Permintaan HTTP menyusun permintaan lengkap. Pilih Metode, masukkan URL, lalu tambahkan Parameter kueri dan Header sebagai pasangan nama dan nilai. Di Jenis isi, pilih none, json, form, text, atau multipart (unggahan file dengan field formulir tambahan). Autentikasi menawarkan basic (nama pengguna dan kata sandi), bearer (token), dan header (token di header yang Anda namai, misalnya X-Api-Key). Status yang diharapkan menentukan jawaban mana yang dianggap berhasil, bawaannya 2xx. Anda juga dapat mengatur Batas waktu, menonaktifkan Ikuti pengalihan, dan membatasi Ukuran respons maks. (byte).

Tangkapan menyimpan bagian dari respons ke dalam variabel. Setiap baris memasangkan nama variabel dengan selektor: $status, $ok, $duration, $body, $truncated, $headers, $header:<name>, atau jalur JSON seperti data.items[0].name. Variabel yang belum ada akan dibuat.

Dapatkan Nilai JSON adalah bentuk singkat untuk membaca satu nilai: masukkan URL, Jalur JSON, dan variabel di Simpan ke variabel.

Contoh penggunaan

• Tombol yang mengirim {"text": "Stream is live"} ke webhook obrolan dengan Kirim Permintaan HTTP dan jenis isi json.
• Tombol yang menyalakan colokan pintar di jaringan Anda melalui API web lokalnya.
• Tombol yang membaca harga terkini dari API publik dengan Dapatkan Nilai JSON dan menampilkannya di labelnya dengan {{ vars.price }}.
• Alur yang mengirim permintaan, menangkap $status, dan menggunakan Jika / Lainnya untuk mewarnai tombol merah saat server tidak menjawab dengan 200.

Nilai parameter kueri dan header dapat berisi variabel, misalnya {{ vars.channel }}. Permintaan berjalan di komputer tempat Macro Deck berjalan, sehingga alamat seperti http://192.168.1.20 menjangkau perangkat di jaringan komputer tersebut. Aksi gagal dengan pesan yang jelas jika server tidak dapat dijangkau, permintaan melewati batas waktu, sertifikat TLS ditolak, atau status tidak sesuai dengan yang diharapkan.