Webhook Hub - 第三方 Webhook 中转服务

欢迎,

用户登录 / 注册

请登录或注册账号以申请 Webhook 服务。账号与 sillymd.com 用户系统互通。

注册

我的 Webhook 服务

创建新的 Webhook 服务

已创建的服务

接入流程演示

1

创建 Webhook 服务

登录后，在"我的 Webhook 服务"中创建新服务，填写：

服务名称：用于标识此服务
回调地址：您的服务器接收 Webhook 的地址

创建成功后，系统会生成唯一的 API Key。

2

将 Webhook 地址提供给第三方

将以下格式的地址提供给需要发送 Webhook 的服务方：

https://webhook.sillymd.com/webhook/{您的API_KEY}/任意路径

例如，如果接入 GitHub：

https://webhook.sillymd.com/webhook/wh_abc123def456/github/events

3

接收转发的 Webhook

当第三方发送 Webhook 到上述地址后，系统会：

接收并存储 Webhook 请求
自动转发到您设置的回调地址
如果失败，自动重试 3 次
添加签名头 X-Webhook-Signature 用于验证

4

验证签名（可选但推荐）

为确保安全，建议验证 Webhook 签名：

import hmac
import hashlib

def verify_signature(payload, signature, secret):
    # signature 格式: "t=timestamp,v1=hash"
    parts = signature.split(',')
    timestamp = parts[0].split('=')[1]
    received_hash = parts[1].split('=')[1]

    message = f"{timestamp}.{payload}"
    expected_hash = hmac.new(
        secret.encode(),
        message.encode(),
        hashlib.sha256
    ).hexdigest()

    return hmac.compare_digest(received_hash, expected_hash)
                    

5

查看日志和重试

在"我的 Webhook 服务"中可以：

查看所有接收的 Webhook 记录
查看转发状态和响应
手动重试失败的 Webhook

功能特性

多租户支持

每个用户独立的 API Key 和配置

自动重试

失败自动重试 3 次，指数退避

请求日志

完整的请求/响应记录和查询

签名验证

HMAC-SHA256 签名保证安全

实时投递

异步转发，低延迟

用户系统

与 sillymd.com 账号互通

API 文档

端点	方法	描述	认证
/api/v1/auth/register	POST	用户注册	否
/api/v1/auth/login	POST	用户登录	否
/api/v1/tenants	POST	创建 Webhook 服务	是
/api/v1/tenants	GET	获取所有服务	是
/api/v1/webhooks	GET	获取 Webhook 历史	是
/webhook/{api_key}/*	ANY	接收 Webhook 事件	API Key

查看完整 API 文档 (Swagger)