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