Webhook

Webhook 颠覆了通常的通信方式。客户端不再反复询问是否有任何变化，而是注册一个专属 URL，当事件发生时，服务器会向该 URL 发送 HTTP 请求。对于这些请求，客户端就变成了服务器。

工作原理

订阅时，您需要向服务提供商提供一个 URL，通常还会收到一个共享密钥。当事件触发时，服务提供商会向该 URL 发送一个 POST 请求，并对其进行签名——通常是在请求头中对原始请求体进行 HMAC 加密。您的端点会验证签名，并快速返回 2xx 响应，然后执行实际操作。服务提供商会重试非 2xx 响应，因此请求可能会多次到达。

误解

收到 webhook 即表示事件为真。未经验证的 webhook 端点是一个公开 URL，任何人都可以向其发送任何 POST 请求。签名是必需的，并且必须基于接收到的原始字节进行计算——先解析并重新序列化 JSON 是导致正确实现验证失败的最常见原因。

点击这里试试

Webhooks API 允许您订阅、触发发送、读取`x-funapi-signature`标头并进行验证——然后篡改有效负载并观察验证失败。

相关内容

• 测试 webhook 和 HMAC 签名验证
• What an HMAC signature is

资料来源

• HMAC — RFC 2104

其他术语

• HMAC签名 — 一个带有密钥的哈希值证明有效载荷来自持有共享密钥的人，并且没有被篡改。
• 请求 ID（关联 ID） — 请求及其日志会附加一个唯一标识符，以便可以追踪一次调用所涉及的每个服务。
• 服务器发送事件 (SSE) — 通过普通的 HTTP 响应，从服务器到客户端单向传输事件流，并且响应保持打开状态。

阅读英文版

所有术语 · 测试技巧 · 全部 39 个模拟 REST API

最后更新时间 2026年10月16日