← 所有工具
我哋嘅筆記

Pipedream RequestBin 睇 UnifyPort webhook 事件流

webhook.site 啱快速確認一句「到底有冇嘢打入嚟?」。但當你要睇住流量慢慢累積——一連串狀態更新、一段跨幾分鐘嘅驗證流程——Pipedream RequestBin 先係更啱嘅收集箱。

佢做啲咩

RequestBin 畀個持久嘅 URL 你,將每條請求都記入一份碌得郁嘅歷史度——headers、raw body、query string、時序——而且會留住,方便你過幾個鐘再返嚟睇。有個 replay 掣可以重發任何一條捕獲到嘅請求,呢樣就係佢唔淨係個被動 viewer 嘅原因。

幾時用佢

  • 睇一連串事件。 一條訊息可能先扇出 message.received,再跟住幾條 message.status.updated。RequestBin 將佢哋順序鋪開,你就確認到成串事件都到齊。
  • 跨幾分鐘嘅驗證流程。 QR 碼同配對流程會先後發 account.auth.requiredaccount.auth.succeededaccount.started,相隔幾秒到幾分鐘。持久嘅收集箱可以全部接住,你唔使一直 hea 喺 terminal 度睇。
  • 一邊改一邊 replay。 捕獲一次,之後改 code 嗰陣將同一條投遞 replay 去你個 handler——好過每次都去氹個渠道再發多次同樣嘅事件。

睇一條 UnifyPort 投遞

每條投遞都帶住標準嘅簽章 headers:

X-Device-Delivery-Id: d_01J2K…
X-Device-Timestamp: 1716800000
X-Device-Signature: 9f8c…

……仲有正規化後嘅事件信封——跨渠道都係同一個結構,所以你照住佢寫一次 handler 就得:

{
  "type": "message.received",
  "data": {
    "conversation": { "title": "Acme support" },
    "attendees": ["+15551234567"]
  }
}

幾時唔好用佢

  • 生產或者含 PII 嘅流量。 RequestBin URL 公開又估得到——攞到條 link 嘅人都讀得到每條捕獲嘅請求。淨係留畀即棄嘅測試事件。
  • 要轉發去 localhost。 RequestBin 淨係捕獲,唔會轉發去你部機。要轉發就用 smee.io 或者 ngrok

我哋都鍾意嘅同類工具

  • webhook.site——一次性確認「有冇嘢入嚟」快啲。
  • smee.io——會轉發去 localhost,唔淨係捕獲。
  • ngrok——完整嘅本地 tunnel,自帶 127.0.0.1:4040 inspector。

常見問題

Pipedream RequestBin 嘅請求可以留幾耐?
夠你喺一段 session 裡面睇住流量累積——比快速確認一下要嘅時間長好多。實際保留幾耐睇你個 Pipedream plan,所以將捕獲嘅請求當測試資料睇,唔好當成存檔。
可唔可以將捕獲到嘅請求 replay 去我本地嘅 handler?
RequestBin replay 去原本嘅目標。想將投遞送去 localhost,用 smee.io 轉發,或者用 ngrok 開 tunnel,再喺嗰邊 replay。
佢同 webhook.site 有咩分別?
兩個都捕獲同顯示請求。webhook.site 喺一次性確認「到咗未」嗰陣最快;RequestBin 喺你想要一份持久、碌得郁、跨一段時間嘅多條投遞歷史嗰陣更啱。

接入 UnifyPort

透過 POST /v1/webhook-endpoints 註冊呢個 bin URL,配上 subscribed_events: ["*"],trigger 幾個事件,睇住佢哋一條條叠起嚟。住先唔好填 signing_secret,等你準備好驗簽嗰陣再用我哋嘅 CyberChef 或者 DevToys 教學確認簽章。