Pipedream RequestBin で UnifyPort webhook のストリームを観察する

何をするもの

RequestBin は永続的な URL を渡してくれて、すべてのリクエストをスクロール可能な履歴に記録します——headers、raw body、query string、タイミング——しかも保持されるので、数時間後に戻って見返せます。replay ボタンで捕捉したリクエストを再送でき、これが単なる受動的ビューアを超える理由です。

どんなときに使うか

• 一連の流れを観察する。 1 通のメッセージが message.received に続いて複数の message.status.updated へと広がることがあります。RequestBin は順番に並べてくれるので、一連が本当に届いたか確認できます。
• 数分にわたる認証フロー。 QR とペアリングのフローは account.auth.required、account.auth.succeeded、そして account.started を数秒〜数分おきに出します。永続的な bin ならターミナルに張り付かなくても全部受け止められます。
• 反復しながら replay。 配信を一度捕捉したら、コードを変えるたびに同じものをハンドラへ replay できます——毎回プロバイダに同じイベントを再送させるより速いです。

UnifyPort の配信を確認する

どの配信にも標準の署名 headers が付いています:

……そして正規化されたイベントのエンベロープ——プロバイダをまたいで同じ形なので、ハンドラは一度それに合わせて書けば済みます:

使わないほうがよいとき

• 本番や PII を含むトラフィック。 RequestBin の URL は公開かつ推測可能です——リンクを知る人は捕捉した全リクエストを読めます。使い捨てのテストイベントに留めましょう。
• localhost への転送。 RequestBin は捕捉はしますが、あなたのマシンへは転送しません。それには smee.io か ngrok を使ってください。

私たちが気に入っている代替

• webhook.site ——「何か届いてる?」の単発チェックはこちらが速いです。
• smee.io ——捕捉だけでなく localhost へ転送します。
• ngrok —— 127.0.0.1:4040 に inspector を内蔵した本格的なローカルトンネル。

よくある質問

Pipedream RequestBin はリクエストをどれくらい保持しますか?

セッションを通してトラフィックの積み上がりを見るには十分——素早いチェックに必要な時間よりずっと長く持ちます。正確な保持期間は Pipedream のプラン次第なので、捕捉したリクエストはアーカイブではなくテストデータと考えてください。

捕捉したリクエストをローカルのハンドラへ replay できますか?

RequestBin は元のターゲットへ replay します。配信を localhost に届けるには、smee.io で転送するか ngrok でトンネルし、そこで replay してください。

webhook.site と何が違いますか?

どちらもリクエストを捕捉して表示します。webhook.site は単発の「届いた?」が最速。RequestBin は時間をかけた多数の配信について、永続的でスクロール可能な履歴がほしいときに向いています。