ブログ
「受ける側」の記事
署名検証の
Webhook のための 生の 本文の 取り方:Express・Next.js・Hono・FastAPI・Django・Rails・Laravel・Go 署名検証に 必要な 生の 本文を、 Express・Next.js・Hono・FastAPI・Django・Rails・Laravel・Go で 取り出して 検証する 最小の コードと、 よく ある 落とし穴を まとめます。 Shopify の
Shopify のWebhook の 仕様:HMAC 検証・5 秒の タイムアウト・再送と 購読の 削除 Webhook の HMAC 検証、 1 秒と 5 秒の タイムアウト、 4 時間で 8 回の 再送と 購読の 削除、 重複と 順番を 公式で 確かめて 表にし、 HMAC が 合わない 3 つの 原因と Node の 検証の コードを 示します。 Webhook の
Webhook が重複と 冪等性:webhook-id・ 一意 制約・処理済みの 記録 重複して 届く 理由と、 受ける 側の 3 つの 守り方 (一意 制約・処理済みの 記録・upsert) 、 同時に 届いた ときの 扱いを、 Stripe・GitHub・Shopify・Slack・LINE の ID の 表と コードで 示します。 Webhook の
Webhook を応答コードの 意味: 受ける 側が 返す値と 送る 側の 扱い 受ける 側が 返すべき 応答コードと、 Stripe・Shopify・GitHub・Slack・LINE・Standard Webhooks が 2xx 以外・3xx・410・429 を どう 扱うかを 表で 整理します。 Webhook を
手元のローカルで 受けて 試す方法:トンネル・各社の CLI・記録からの 再送 開発環境で Webhook を 受けて 試す 3 つの 方法 (ngrok・cloudflared の トンネル、 Stripe CLI などの 各社の CLI、 記録した 本文の 送り直し) を、 URL の 固定・無料の 範囲・署名の 扱い・外に 開く 危険で 比べます。 Webhook の
Webhook の署名検証が 失敗する 原因:生の 本文・鍵の 取り違え・時刻・プロキシ 署名検証が 通らない ときの 原因を 多い 順に 並べ、 切り分けの 手順と、 Stripe・Shopify・GitHub・Slack・LINE・Twilio・Standard Webhooks の 署名の 対象と 符号化の 違いを 表で 整理します。