Tentang webhook

Webhooks memungkinkan anda untuk mengirimkan permintaan POST pada sebuah URL tertentu setiap kali sebuah peringatan terpicu. Fitur ini dapat dinyalakan saat anda membuat atau mengedit sebuah peringatan. Tambahkan URL yang benar dari app anda dan kami akan mengirimkan sebuah permintaan POST begitu peringatan tersebut terpicu, dengan pesan peringata pada badan dari permintaan tersebut. Jika sebuah pesan peringatan adalah sebuah JSON yang valid, kami akan mengirimkan permintaan dengan header tipe konten "application/json". Jika tidak, kami akan mengirimkan "text/plain" sebagai header tipe kontennya.

Pemberitahuan Keamanan Penting: Saat mengkonfigurasi webhook, pastikan anda tidak menyertakan informasi yang sensitif seperti kredensial login atau kata sandi pada body webhook. Mengirimkan data sensitif melalui webhook dapat menjadikannya terpapar ke pihak-pihak yang tidak bertanggungjawab dan menyebabkan kerentanan terhadap keamanan. Selalu gunakan endpoint yang aman dan terautentikasi serta enkripsi data yang sensitif untuk melindungi informasi anda.

Berikut adalah daftar dari alamat IP yang akan kami gunakan untuk mengirimkan permintaan POST, apabila IP tersebut perlu untuk diberikan izin:

• 52.89.214.238
• 34.212.75.30
• 54.218.53.128
• 52.32.178.7

Jika anda ingin mengirimkan permintaan ke sebuah URL dengan nomor port, harap dicatat bahwa kami hanya menerima URL dengan nomor port 80 dan 443. Permintaan pada URL dengan nomor port yang lain akan kami tolak. Jika sebuah server remote memproses permintaannya lebih dari 3 detik maka permintaannya akan dibatalkan. 

Harap diingat bahwa sejumlah app dan layanan memerlukan penerimaan data dari webhook ini dalam format JSON (dan bukan teks biasa sebagaimana yang kami miliki pada pesan peringatan secara bawaannya). Sebelum mengirimkan permintaannya, harap baca terlebih dahulu dokumentasi dari app atau layanan yang bersangkutan dan formatlah pesan peringatan anda secara tepat. Anda dapat mengetahui lebih lanjut mengenai format JSON pada wiki.

Sebagai contoh, Slack menunggu sebuah pesan yang berada dalam format JSON dengan sebuah "text" sebagai kuncinya. Anda dapat mengetikkan sebagai berikut pada kotak pesannya:

{"text": "BTCUSD Greater Than 9000"}

Karena pesan tersbeut adalah sebuah JSON yang valid, kami akan mengirimkan sebuah permintaan dengan sebuah header tipe konten "application/json". Berikut adalah tampilan dari permintaan tersebut dengan menggunakan cURL:

curl -H 'Content-Type: application/json; charset=utf-8' -d '{"text": "BTCUSD Greater Than 9000"}' -X POST https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Jika pesan anda berada dalam teks biasa (cth., anda menggunakan pesan peringatan bawaan), kami akan mengirimkan sebuah permintaan dengan sebuah header tipe konten "plain/text". 

curl -H 'Content-Type: text/plain; charset=utf-8' -d 'BTCUSD Greater Than 9000' -X POST https://webhook.site/test

Untuk perlindungan data anda, penggunaan webhook peringatan hanya diperbolehkan jika otentikasi 2 faktor telah diaktifkan.