关于webhooks

Webhooks允许您在每次触发快讯时将POST请求发送到某个URL。建立或编辑警报时可以启用此功能。为您的app添加正确的URL，警报触发后，我们会立即发送POST请求，并将警报信息显示在请求的正文中。如果警报信息是有效的JSON文本，我们将发送带有 “application/json” 内容类型标头的请求。否则，我们将发送 “text/plain” 作为内容类型标头。

如果您需要获得POST许可，以下是我们将用于发送POST请求的IP地址的列表：

52.89.214.238

34.212.75.30

54.218.53.128

52.32.178.7

如果您想向带有port号的URL发送请求，请注意，我们只接受port号为80和443的URL。对具有任何其他port号的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/XXXXXXXXXXXXXXXXXXXXXXX

如果您的信息为 plain text 格式（例如，您使用的是预设快讯讯息），我们将发送带有 “plain/text” 内容类型标题的请求。

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