用途:Hookdeck 是一个 Webhook 管理工具,帮助开发者可靠地接收和处理来自第三方服务的 Webhook,提供监控、告警、转换和重试等能力,确保 Webhook 正确投递与处理。本技能用于在 Hookdeck 数据上进行交互,例如管理 Connections、Issues、Workflows。
主要能力:围绕连接(Connections,事件来源)、事件(Events)、目标(Destinations,事件投递位置)以及工作区、API 密钥、团队、成员、用户、事件类型、转换模板、仪表盘、日志等对象进行读取与操作。常见动作包括 List Connections、List Destinations、List Sources、List Events、List Requests、List Attempts、List Transformations、List Issues,以及对应的 Get 单条查询,还有 Create Connection、Create Destination、Create Source、Update Connection 等写入动作,均支持过滤与分页参数。
使用方式:安装 Membrane CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无交互环境会打印授权 URL,用户完成登录后执行 membrane login complete <code>。建立连接:membrane connection ensure "https://hookdeck.com/" --json;若状态为 BUILDING 可轮询 npx @membranehq/cli connection get <id> --wait --json 直至 READY。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。执行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,可用 --input '{"key":"value"}' 传参,结果在 output 字段。若动作不覆盖需求,可用代理直接请求 Hookdeck API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
适用场景:开发者或工程团队需要构建与外部 API 的稳健集成,管理 Hookdeck 的源、目标、连接、事件、投递尝试、转换和问题等数据时使用。
限制:官方文档为 https://hookdeck.com/docs;认证与凭证刷新由 Membrane 自动处理,不应向用户索取 API 密钥或令牌,应通过创建连接完成。具体动作的输入输出结构需通过 action list 查询获得;其他未在资料中说明的功能、收费、价格或平台支持情况暂未提供。