SuperAPI AI 工具集

bitbucket-webhooks

测试与质量

查看项目

更新于 10-15 22:14

技能介绍

用途:该技能面向 Bitbucket Cloud Webhook 的接入与验证,适合在设置 Webhook 处理程序、调试签名验证失败、理解事件键与负载,以及处理 repo:push、pull request、issue 等事件时使用。

核心验证:Bitbucket 用 Webhook 密钥对原始请求体做 HMAC-SHA256,摘要放在 X-Hub-Signature 头中,格式为 sha256=<hex>。验证时需使用原始请求体并做时序安全比较。未配置密钥的 Webhook 不签名,也不会发送 X-Hub-Signature 头。资料提供了 Node 与 Python 的验证函数示例,完整处理器(路由接线、事件分发与测试)见 examples/express/、examples/nextjs/、examples/fastapi/。

常见事件键:repo:push(推送提交)、pullrequest:created(新建 PR)、pullrequest:updated(更新 PR)、pullrequest:approved(PR 被批准)、pullrequest:fulfilled(PR 合并)、pullrequest:rejected(PR 被拒绝)、pullrequest:comment_created(PR 评论)、issue:created(新建议题)。

重要请求头:X-Hub-Signature(sha256=<hex>,仅设置密钥时存在)、X-Event-Key(事件类型)、X-Request-UUID(唯一投递 ID)、X-Attempt-Number(该次投递的重试次数)。

环境变量:BITBUCKET_WEBHOOK_SECRET=your_webhook_secret,在 Bitbucket 创建 Webhook 时设置。

本地开发:npx hookdeck-cli listen 3000 bitbucket --path /webhooks/bitbucket

参考材料:references/overview.md(概念与事件)、references/setup.md(仓库/工作区配置)、references/verification.md(签名验证细节)。建议搭配 webhook-handler-patterns 技能,处理先验证后解析、幂等、错误处理与重试逻辑。

限制:资料未提供价格、平台支持范围或具体部署要求。