开发者

网络钩子 (Webhooks)

您账户产生的所有通知都可以作为带签名的 JSON POST 直接发送到您自己的系统——因此,您的托管服务上发生的事情可以在任何其他地方启动工作流。

您可以将其连接至

Webhook 是普通的 HTTPS 请求,因此任何能够接收请求的工具都可以对其进行处理。您无需让我们为您的工具构建集成。

自动化平台

将 Webhook 指向 n8n, Make, Zapier, Pipedream, Activepieces 中的工作流,每个事件都将成为一个触发器——发送到频道、打开工单、更新电子表格或调用另一个 API。自托管平台的工作方式完全相同,只要可以通过 HTTPS 访问该端点即可。

CRM 和服务台

将账单和账户事件发送到 HubSpot, Pipedrive, Salesforce,或发送至具有入站 webhook 的任何服务台或 CRM,以便客户记录能够反映其托管服务的动态,而无需任何人进行手动复制。

其他任何正在监听的事物

Slack, Discord, Google Sheets, Airtable, Notion,无论是您自己的监控、数据仓库还是您编写的小脚本。只要它能接受 HTTPS POST 并读取 JSON,它就能接收这些内容。

发送内容

您可以自行选择将哪些类别发送至哪个目标位置——并且您可以连接多个目标,从而让账单发送至一个地方,而站点警报发送至另一个地方。默认情况下,所有内容均为开启状态。

账单与付款

已开具并已支付的发票、支付失败的款项、即将过期的银行卡、续费与取消。

网站与安全

配置完成、站点已暂停、发现恶意软件、备份及证书更改。

支持与域

已开启和升级的工单、域名转移、续费以及 DNS 更改。

证明请求来自我们

每个请求都用只有你和我们才知道的密钥进行签名。在处理正文之前请检查签名——每次发送都会附带以下标头:

X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: stable id for this delivery
X-Zinn-Event: invoice.paid

时间戳与正文一起签名,而不是在正文旁边发送,因此截获的请求以后无法被重新发送攻击您。请拒绝任何超过几分钟的请求。

您的签名密钥在添加 webhook 时仅显示一次。我们无法再次显示该密钥——如果您丢失了它,请删除该目标并重新添加。

正在设置

  1. 在您的控制面板中,打开“通知”并添加一个 Webhook 类型的目标。
  2. 请向其提供您的 HTTPS 终端节点,并复制我们向您展示的签名密钥。
  3. 点击测试。我们会发送一个与正式请求格式相同的真实请求,以便您在发生任何实际情况之前进行针对性开发。
  4. 选择该目的地应接收的类别。新类型的通知将自动开启。

你可以添加任意数量的目标位置,将 webhook 与电子邮件、Slack 和 Telegram 结合使用,并为每个位置分配不同的类别组。

更愿意给我们打电话?

Webhook 用于告知您何时发生了某事。API 则用于让事情发生——面板执行的每项操作您都可以使用。

浏览 API 参考