關於webhooks

Webhooks允許您在每次觸發快訊時將POST請求發送到某個URL。建立或編輯快訊時可以啟用此功能。為您的app添加正確的URL，快訊觸發後，我們會立即發送POST請求，並將快訊訊息顯示在請求的正文中。如果快訊訊息是有效的JSON，我們將發送帶有 “application/json” 內容類型標頭的請求。否則，我們將發送 “text/plain” 作為內容類型標頭。

重要安全性聲明：設定Webhook時，請確保不在Webhook內文中包含登入憑證或密碼等敏感資訊。透過Webhook傳輸敏感資料可能會將其暴露給未經授權的各方並導致安全漏洞。始終使用安全性、經過驗證的端點並加密敏感資料來保護您的資訊。

如果需要獲得POST許可，以下是我們將用於發送POST請求的IP地址的列表：

• 52.89.214.238
• 34.212.75.30
• 54.218.53.128
• 52.32.178.7

如果您想向帶有連接埠的URL發送請求，請注意，我們只接受連接埠為80和443的URL。對具有任何其他連接埠的URL的請求將被拒絕。如果遠端伺服器處理請求的時間超過3秒鐘，則該請求將被取消。

請記住，許多app和服務希望以JSON格式（而不是預設情況下快訊訊息中包含的純文本）接收來自webhooks的數據。在發送請求之前，請閱讀相應app或服務的文件，並正確設定快訊訊息的格式。您可以在Wiki中找到有關JSON格式的更多資訊。

例如，Slack正在等待以“text”為鍵值的JSON格式的訊息。您可以在訊息框中輸入：

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

由於此訊息是有效的JSON，因此我們將發送帶有 “application/json” 內容類型標頭的請求。使用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

如果您的訊息為 plain text 格式（例如，您使用的是預設快訊訊息），我們將發送帶有 “plain/text” 內容類型標題的請求。

cURL:

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

為了保護您的數據，僅在啟用雙重因素身分驗證的情況下，才允許使用快訊Webhooks。