用途:该技能用于搭建 OpenAI Webhook 处理程序,接收并验证 OpenAI 推送的异步事件,覆盖微调任务、Batch API 完成通知以及 Realtime API 来电等场景,也可用于排查签名验证失败。
主要能力:提供 Express 与 Python FastAPI 的 Webhook 处理示例,实现基于 Standard Webhooks 的签名验证,包括校验时间戳(5 分钟窗口以防重放)、解析 v1 版本签名、以 webhook_id.webhook_timestamp.payload 构造签名内容、对 whsec_ 前缀密钥做 base64 解码并用 HMAC-SHA256 生成期望签名,最后做时序安全比较。示例还演示按事件类型分发处理。
支持的事件类型包括 fine_tuning.job.succeeded、fine_tuning.job.failed、fine_tuning.job.cancelled、batch.completed、batch.failed、batch.cancelled、batch.expired、realtime.call.incoming。
使用方式:需设置环境变量 OPENAI_API_KEY 与 OPENAI_WEBHOOK_SECRET。Webhook 端点必须使用原始请求体(如 express.raw({ type: 'application/json' })),先验证签名再解析负载。本地开发可用 npx hookdeck-cli listen 3000 openai --path /webhooks/openai 启动隧道。完整示例见 examples/express、examples/nextjs、examples/fastapi。
限制与说明:资料未提供收费、价格与平台支持范围等信息;建议配合 webhook-handler-patterns 技能处理幂等、错误处理与重试逻辑。