SuperAPI AI 工具集

mailchimp-webhooks

通用与其它

查看项目

更新于 10-15 22:14

技能介绍

用途:帮助开发者搭建 Mailchimp Webhook 处理器,包括响应 URL 验证、保护端点、解析负载与分发受众事件。

主要能力:Mailchimp 不对 Webhook 做 HMAC 签名,因此需两种方式保护端点。其一为 URL 验证:保存 Webhook 时 Mailchimp 会发送 GET 请求确认可达,应返回 200,且 GET 不要求密钥。其二为共享密钥:在 Webhook URL 查询串中放入不可猜测的 secret(如 https://your.app/webhooks/mailchimp?secret=…),每次 POST 用定时安全比较校验,并始终使用 HTTPS。负载为 application/x-www-form-urlencoded,含顶层 type 字段与 data[...] 字段。

常见事件按 type 分发:subscribe(加入受众)、unsubscribe(离开,含 action、reason)、profile(更新资料)、upemail(更换邮箱)、cleaned(地址被清理,含 reason)、campaign(活动发送完成)。

使用方式:设置环境变量 MAILCHIMP_WEBHOOK_SECRET,注册 URL 为 https://your.app/webhooks/mailchimp?secret=<值>。本地开发可用 npx hookdeck-cli listen 3000 mailchimp --path /webhooks/mailchimp 启动隧道。示例处理器见 examples/express/、examples/nextjs/、examples/fastapi/。

限制:资料未提供收费、价格与平台支持等细节;Mailchimp 无签名头,安全性依赖共享密钥与 HTTPS。建议配合 webhook-handler-patterns 技能处理幂等、错误与重试。