AnyInt Docs
企业

Webhook 与通知

企业客户需要将运营事件推送到他们自己的系统中,而不是手动查看仪表盘。

企业客户需要将运营事件推送到他们自己的系统中,而不是手动查看仪表盘。

交付渠道

渠道最适合
电子邮件通知人工审核以及财务或安全警报
Webhook自动化和系统对系统处理

如何选择渠道

事件类型更适合邮件的情况更适合 webhook 的情况
计费财务负责人需要审核或批准你的会计或内部工单系统需要接收事件
用量限制需要人工决定是否提高限制平台需要自动降速任务或通知值班
成员变更管理员需要审计通知安全工具跟踪身份生命周期事件
key 变更负责人需要可见性内部系统需要轮换、禁用或排查 key
安全告警安全负责人必须审核SIEM、Pager 或事故流程需要收到事件

典型电子邮件通知

  • 生成账单
  • 支出或使用量警告
  • 成员变更
  • 安全警报

Webhook 配置模型

当前企业方案描述了三个关键字段:

  • webhook URL
  • 订阅的事件类型
  • 签名密钥

接收端要求

Webhook 接收端应按生产集成点设计:

  1. 使用公开 HTTPS 端点。
  2. 在信任 payload 前校验签名密钥。
  3. 快速返回,把慢任务放入队列。
  4. 让处理具备幂等性,避免重复投递触发重复动作。
  5. 保存 event ID、事件类型、任务或资源 ID、接收时间和处理状态。
  6. 保留轮询或控制台查看作为 webhook 延迟时的兜底。

示例事件领域

  • billing.generated
  • billing.paid
  • billing.overdue
  • usage.alert
  • usage.limit_reached
  • member.invited
  • member.joined
  • member.removed
  • key.created
  • key.disabled
  • key.deleted

集成检查清单

在生产中依赖 webhook 前,请确认 webhook URL、订阅的事件类型、签名密钥、重试行为,以及你的系统需要保存的事件 payload 字段。

相关页面

On this page