Mengenai Webhooks

Webhooks membenarkan anda menghantar satu permintaan POST kepada URL tertentu setiap kali pemberitahuan tercetus. Ciri ini boleh diaktifkan apabila anda mencipta atau mengedit satu pemberitahuan. Tambah kepada URL yang betul untuk aplikasi anda dan kami akan menghantar satu permintaan POST sebaik sahaja pemberitahuan tercetus, dengan mesej pemberitahuan di dalam badan permintaan. Jika mesej pemberitahuan ialah JSON yang sah, kami akan menghantar satu permintaan dengan satu pengepala jenis kandungan "application/json". Sekiranya tidak, kami akan menghantar satu pengepala jenis kandungan "text/plain".

Notis Sekuriti Penting: Apabila mengkonfigurasikan webhook, pastikan anda tidak memasukkan maklumat sensitif seperti maklumat log masuk atau kata kunci dalam badan webhook. Menghantar data sensitif menerusi webhook boleh mendedahkannya kepada pihak tidak dikehendaki dan boleh menjadi kelemahan sekuriti. Sentiasa gunakan data yang selamat, disahkan dan disulitkan untuk melindungi maklumat anda.

Di sini ialah senarai alamat-alamat IP yang kami akan gunakan untuk menghantar permintaan POST, sekiranya mereka perlu diberikan kebenaran:

• 52.89.214.238
• 34.212.75.30
• 54.218.53.128
• 52.32.178.7

Jika anda mahu menghantar satu permintaan kepada satu URL dengan satu nombor sumber (port), sila maklum bahawa kami hanya menerima URL dengan nombor sumber (port) 80 dan 443. Permintaan untuk URL dengan nombor sumber lain akan ditolak. Jika satu pelayan jauh memproses satu permintaan untuk lebih daripada 3 saat, permintaan itu akan dibatalkan. Juga harap maklum bahawa IPv6 tidak berfungsi dengan webhook pada masa ini, tetapi kami mungkin akan menggunakannya di masa hadapan.

Sila ingat bahawa banyak aplikasi dan perkhidmatan dijangka akan menerima data dari webhook dalam format JSON dan bukan teks biasa (plain text), di mana kami ada dalam mesej pemberitahuan secara lalai. Sebelum menghantar satu permintaan, sila baca dokumentasi untuk aplikasi atau perkhidmatan yang berkenaan dan formatkan mesej pemberitahuan anda seperti yang diperlukan. Anda boleh membaca lebih mengenai format JSON di dalam wiki.

Sebagai contoh, Slack sedang menunggu satu mesej yang diformatkan dalam JSON dengan satu “text” sebagai satu kekunci. Anda boleh menaipnya di dalam kotak mesej:

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

Disebabkan mesej ialah satu JSON yang sah, kami akan menghantar satu permintaan dengan satu pengepala jenis kandungan "application/json". Di sini bagaimana permintaan akan kelihatan 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 mesej anda adalah dalam teks biasa (plain text) (cth. anda menggunakan mesej pemberitahuan lalai), kami akan menghantar satu permintaan dengan satu pengepala jenis kandungan "plain/text".

cURL:

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 pemberitahuan webhooks hanya dibenarkan dengan pengesahan 2 faktor diaktifkan.