SuperAPI AI 工具集

klaviyo-prod-checklist

部署与运维

查看项目

更新于 10-15 23:26

技能介绍

用途:在将 Klaviyo 集成部署到生产环境前,执行完整的部署检查清单与验证流程,覆盖上线准备、健康检查与回滚。

主要能力:提供预部署检查清单,包括认证与密钥(生产私钥存于密钥管理器、最小权限、Webhook 签名密钥、公开密钥、禁止硬编码密钥)、API 集成(使用 klaviyo-api SDK、固定 SDK 版本、设置 revision 头、使用 createOrUpdateProfile 做 upsert、事件唯一 ID 去重、E.164 电话格式)、错误处理与韧性(429 遵循 Retry-After、5xx 指数退避、401/403 告警、熔断降级、请求队列不超过 75 req/s)、Webhook 安全(仅 HTTPS、HMAC-SHA256 验签、幂等去重、30 秒内返回 200)以及监控(健康检查含 Klaviyo 连通性、429/401/403/5xx 与延迟告警、监控状态页)。

使用方式:按顺序执行——先审计密钥与代码(如 grep -r "pk_" src/),再审计集成、韧性与 Webhook,然后运行预检脚本 scripts/preflight-klaviyo.sh 验证状态页、API 认证、速率余量与 SDK 版本,部署后验证健康端点,并保持回滚路径(优先功能开关)。健康检查、预检脚本与回滚代码见 references/implementation.md。

适用场景:Klaviyo 集成上线前的生产就绪验证、发布前审计与故障响应演练。

限制:仅当清单完成、预检四项全绿且健康端点返回 healthy 时才视为生产就绪;预检认证失败(401/403)须先轮换或修复密钥,不得继续部署。具体实现细节与示例见资料中的 references 文件,其余未提供。