Giới thiệu về webhooks

Webhook cho phép bạn gửi yêu cầu ĐĂNG đến một URL nhất định mỗi khi cảnh báo được kích hoạt. Tính năng này có thể được bật khi bạn tạo hoặc chỉnh sửa cảnh báo. Thêm URL chính xác cho ứng dụng của bạn và chúng tôi sẽ gửi yêu cầu ĐĂNG ngay sau khi cảnh báo được kích hoạt, với thông báo cảnh báo trong nội dung yêu cầu. Nếu thông báo cảnh báo là JSON hợp lệ, chúng tôi sẽ gửi một yêu cầu có tiêu đề loại nội dung "application / json". Nếu không, chúng tôi sẽ gửi "văn bản / thuần túy" dưới dạng tiêu đề loại nội dung.

Dưới đây là danh sách các địa chỉ IP mà chúng tôi sẽ sử dụng để gửi các yêu cầu POST, trong trường hợp chúng cần được cấp phép:

52.89.214.238
34.212.75.30
54.218.53.128
52.32.178.7

Nếu bạn muốn gửi yêu cầu đến URL có số cổng, xin lưu ý rằng chúng tôi chỉ chấp nhận URL có số cổng 80 và 443. Yêu cầu đối với URL có bất kỳ số cổng nào khác sẽ bị từ chối. Nếu một máy chủ từ xa xử lý một yêu cầu trong hơn 3 giây, thì yêu cầu đó sẽ bị hủy. Cũng xin lưu ý rằng IPv6 hiện không hoạt động với webhook, nhưng chúng tôi có thể triển khai điều này trong tương lai.

Hãy nhớ rằng nhiều ứng dụng và dịch vụ mong đợi nhận dữ liệu từ webhook ở định dạng JSON chứ không phải ở dạng văn bản thuần túy mà chúng tôi có trong thông báo cảnh báo theo mặc định. Trước khi gửi yêu cầu, vui lòng đọc tài liệu của ứng dụng hoặc dịch vụ tương ứng và định dạng thông báo cảnh báo của bạn cho phù hợp. Bạn có thể tìm hiểu thêm về định dạng JSON trong wiki.

Ví dụ: Slack đang chờ một tin nhắn được định dạng bằng JSON với "văn bản" làm khóa. Bạn có thể nhập vào một hộp tin nhắn:

{"text": "BTCUSD Lớn hơn 9000"}

Vì thư là JSON hợp lệ, chúng tôi sẽ gửi yêu cầu có tiêu đề kiểu nội dung "application / json". Đây là cách yêu cầu sẽ trông như thế nào khi sử dụng 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

Nếu tin nhắn của bạn ở dạng văn bản thuần túy (tức là bạn đang sử dụng tin nhắn cảnh báo mặc định), chúng tôi sẽ gửi yêu cầu có tiêu đề loại nội dung "thuần túy / văn bản".

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