# WebHook 示例项目

这个项目展示了 WebHook 的基本概念和实现方式，包含两个服务：
- Publisher：发布事件并向订阅者发送 WebHook 通知
- Subscriber：接收和处理 WebHook 通知

## 功能特点

1. WebHook 订阅管理
2. 异步事件发布
3. 签名验证机制
4. 失败重试机制
5. 事件类型支持

## 项目结构

```
webhook-example/
├── publisher/           # WebHook 发布者服务
├── subscriber/          # WebHook 接收者服务
```

## 运行说明

1. 启动 Publisher 服务（端口 8080）
```bash
cd publisher
mvn spring-boot:run
```

2. 启动 Subscriber 服务（端口 8081）
```bash
cd subscriber
mvn spring-boot:run
```

## API 使用示例

1. 注册 WebHook 订阅：
```bash
curl -X POST http://localhost:8080/api/webhooks/subscribe \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Test Webhook",
    "url": "http://localhost:8081/api/webhook/receive",
    "secret": "your-secret-key"
  }'
```

2. 发布事件：
```bash
curl -X POST http://localhost:8080/api/webhooks/publish \
  -H "Content-Type: application/json" \
  -d '{
    "type": "user.created",
    "description": "New user registration",
    "data": {
      "userId": "123",
      "email": "test@example.com"
    }
  }'
```

## 安全性考虑

1. 使用 HTTPS 进行通信
2. 实现签名验证机制
3. 使用 Secret Key 保护 WebHook 端点
4. 实现速率限制

## 最佳实践

1. 实现幂等性处理
2. 添加重试机制
3. 设置超时限制
4. 记录详细的日志
5. 实现监控和告警机制