mcpField
W
webhook-development

webhook-development

github.com/aj-geddes开发373506 次安装34 周前更新
代码仓库

关于 webhook-development

用于构建事件驱动集成的 Webhook 开发技能，涵盖事件投递、签名验证、重试和死信处理，并提供事件架构及 Node.js、Python 处理程序参考。

主要功能

  1. 01事件投递模式
  2. 02签名验证
  3. 03重试逻辑
  4. 04死信处理
  5. 05架构与处理程序参考指南

适用场景

  1. 01发送实时通知
  2. 02集成第三方平台
  3. 03触发自动化工作流
  4. 04投递支付或订单事件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aj-geddes/useful-ai-prompts --skill webhook-development

安装后在 Claude Code 中输入/webhook-development确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
best-practices.md
nodejs-webhook-service.md
python-webhook-handler.md
webhook-event-schema.md
scripts/
validate-schema.sh
templates/
migration-template.sql

详细介绍

Webhook 开发

目录

概述

构建可靠的 Webhook 系统，支持事件投递、签名验证、重试逻辑和死信处理，以实现异步集成。

适用场景

  • 向外部系统发送实时通知
  • 实现事件驱动架构
  • 与第三方平台集成
  • 构建审计跟踪和日志系统
  • 触发自动化工作流
  • 投递支付或订单通知

快速入门

最小可运行示例：

{
  "id": "evt_1234567890",
  "timestamp": "2025-01-15T10:30:00Z",
  "event": "order.created",
  "version": "1.0",
  "data": {
    "orderId": "ORD-123456",
    "customerId": "CUST-789",
    "amount": 99.99,
    "currency": "USD",
    "items": [
      {
        "productId": "PROD-001",
        "quantity": 2,
        "price": 49.99
      }
    ],
    "status": "pending"
  },
  "attempt": 1,
  "retryable": true
}

参考指南

references/ 目录中的详细实现：

指南内容
Webhook 事件架构Webhook 事件架构
Node.js Webhook 服务Node.js Webhook 服务
Python Webhook 处理程序Python Webhook 处理程序
最佳实践最佳实践、Webhook 事件

最佳实践

✅ 应该做
  • 遵循既定模式和惯例
  • 编写整洁、易于维护的代码
  • 添加适当的文档
  • 部署前进行充分测试
❌ 不要做
  • 跳过测试或验证
  • 忽略错误处理
  • 将配置值硬编码

评论

支持 Markdown