SuperAPI AI 工具集

stripe-health

通用与其它

查看项目

更新于 10-16 03:42

技能介绍

用途:对 Stripe Webhook 集成做全面诊断,适用于部署 webhook 处理器前、报告订阅同步问题、配置新 webhook 端点后以及事故排查。

主要能力:列出项目所有 webhook 端点并检查状态与已启用事件;检测端点是否返回 3xx 重定向(Stripe 不会向重定向地址投递);查看最近事件的 pending_webhooks 计数;统计投递失败事件数量;重发最近事件以测试实际投递,并提示查看 Vercel 日志确认。

使用方式:依次执行资料中的命令。列出端点:stripe webhook_endpoints list --api-key "$STRIPE_SECRET_KEY" 2>&1 | jq '.data[] | {id, url, status, enabled_events}'。检查重定向:先取 WEBHOOK_URL,再 curl -s -I -X POST "$WEBHOOK_URL" 2>&1 | head -5。查看最近事件:stripe events list --limit 5 --api-key "$STRIPE_SECRET_KEY" 2>&1 | jq '.data[] | {id, type, created: (.created | todate), pending_webhooks}'。统计失败:stripe events list --limit 20 ... | jq '[.data[] | select(.pending_webhooks > 0)] | length'。重发测试:stripe events resend "$RECENT_EVENT" --webhook-endpoint "$ENDPOINT_ID" --api-key "$STRIPE_SECRET_KEY",并用 vercel logs your-app --json | grep webhook 观察日志。最后按资料给出的健康报告格式输出端点数量、重定向检查、近期投递与建议。

常见问题与修复:pending_webhooks 持续偏高多为重定向或 URL 错误,用 curl -I 检查并改为规范域名;重复端点应删除旧端点保留密钥匹配的一个;事件未出现需在端点补充所需事件;签名验证失败需从 Stripe 仪表盘获取正确密钥并更新环境变量。

限制:资料未提供该技能的安装方式、依赖版本、支持的平台范围及收费信息,暂未提供。