Bắt đầu

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.

Thông báo bảo mật quan trọng: Khi định cấu hình webhook, hãy đảm bảo rằng bạn không đưa thông tin nhạy cảm như thông tin xác thực đăng nhập hoặc mật khẩu vào nội dung webhook. Việc truyền dữ liệu nhạy cảm qua webhooks có thể khiến dữ liệu đó bị lộ cho các bên trái phép và dẫn đến các lỗ hổng bảo mật. Luôn sử dụng các điểm cuối an toàn, được xác thực và mã hóa dữ liệu nhạy cảm để bảo vệ thông tin của bạn.

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:

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