webhook-tester

一个零依赖的本地 Webhook 命令行测试工具。

使用

启动本地接收端：

cd webhook-tester
node ./bin/webhook-tester.js listen --port 8787 --secret test --save requests.jsonl

启动 mem9 Webhook 接收端并校验签名：

node ./bin/webhook-tester.js listen \
  --port 8787 \
  --signature-header X-Mem9-Signature \
  --signature-mode mem9 \
  --secret 'whsec_xxx' \
  --save requests.jsonl

发送一条测试 Webhook：

node ./bin/webhook-tester.js send \
  --url http://127.0.0.1:8787/webhook \
  --json '{"event":"ping","ok":true}' \
  --secret test

也可以安装成命令：

cd webhook-tester
npm link
webhook-tester listen --port 8787

功能

• listen：监听 POST /webhook，在终端打印 headers、body、JSON 内容。
• /_requests：返回最近 50 条请求，方便浏览器或脚本查看。
• --secret：校验 X-Hub-Signature-256 的 HMAC SHA-256 签名。
• --signature-mode mem9：按 mem9 的 timestamp.event_id.payload 格式校验 X-Mem9-Signature。
• --save requests.jsonl：把收到的请求追加保存为 JSONL。
• send：向指定 URL 发送测试请求，并可使用同一个 secret 自动签名。

常用参数

webhook-tester listen --host 0.0.0.0 --port 8787 --path /webhook
webhook-tester listen --response-status 202 --response-body accepted
webhook-tester send --url http://127.0.0.1:8787/webhook --body hello
webhook-tester send --url http://127.0.0.1:8787/webhook --header X-Event=ping --json '{"x":1}'