Webhook hakkında daha fazla bilgi edinmek istiyorum
Webhooks, alarmın her tetiklenişinde belirli bir URL’ye POST isteği göndermenizi sağlar. Bir alarm oluştururken veya düzenlerken bu özellik etkinleştirilebilir. Uygulamanız için doğru URL’yi ekleyin; alarmın tetiklendiği anda, isteğin gövdesindeki alarm iletisiyle bir POST isteği göndeririz. Alarm mesajı geçerli bir JSON ise, "application/json" içerik tipi başlığına sahip bir istek göndeririz. Aksi takdirde, bir içerik tipi başlığı olarak "text/plain" u göndereceğiz.
Önemli Güvenlik Uyarısı: Web kancalarını yapılandırırken, web kancası gövdesine oturum açma bilgileri veya parolalar gibi hassas bilgiler eklemediğinizden emin olun. Hassas verilerin web kancaları aracılığıyla iletilmesi, bu verilerin yetkisiz tarafların eline geçmesine ve güvenlik açıklarına yol açabilir. Bilgilerinizi korumak için her zaman güvenli, kimliği doğrulanmış uç noktalar kullanın ve hassas verileri şifreleyin.
POST isteklerini göndermek için kullanacağımız IP adreslerinin bir listesi aşağıda verilmiştir:
- 52.89.214.238
- 34.212.75.30
- 54.218.53.128
- 52.32.178.7
Bağlantı noktası numarası olan bir URL’ye bir istek göndermek istiyorsanız, lütfen yalnızca 80 ve 443 numaralı port noktalarına sahip URL’leri kabul ettiğimizi unutmayın. URL’deki istek, başka bir bağlantı noktası numarasıyla reddedilir. Bir uzak sunucu bir isteği 3 saniyeden fazla bir süre boyunca işlerse, istek iptal edilir.
Pek çok uygulama ve hizmetin JSON biçimindeki web kancalarından veri almayı beklediğini unutmayın (varsayılan olarak alarm iletisinde bulunan düz metni değil). Bir istek göndermeden önce, lütfen ilgili uygulamanın veya hizmetin belgelerini okuyun ve alarm mesajınızı doğru şekilde biçimlendirin. Wiki'deki JSON formatı hakkında daha fazla bilgi bulabilirsiniz.
Örneğin, Slack, JSON'da biçimlendirilmiş bir iletiyi anahtar olarak “metin” ile bekliyor. Bir mesaj kutusuna yazabilirsiniz:
{"text": "BTCUSD Greater Than 9000"}
Mesaj geçerli bir JSON olduğundan, "application / json" içerik tipi başlığına sahip bir istek göndereceğiz. İsteğin cURL kullanmak gibi göründüğü gibi:
curl -H 'Content-Type: application/json; charset=utf-8' -d '{"text": "BTCUSD Greater Than 9000"}' -X POST https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXXMesajınız düz metin içeriyorsa (örneğin, varsayılan bir alarm mesajı kullanıyorsanız), "düz/metin" içerik türü başlığına sahip bir istek göndeririz. Veri güvenliğiniz için, alarm web kancalarının kullanılmasına yalnızca 2 faktörlü kimlik doğrulama etkinleştirildiğinde izin verilir.
curl -H 'Content-Type: text/plain; charset=utf-8' -d 'BTCUSD Greater Than 9000' -X POST https://webhook.site/test