Osiryn Relay ドキュメント
Osiryn Relayは、外部サービスから送信されるWebhookを一時的に受け留め、ご自身のサーバーへ安全に配信(リレー)するミドルウェアです。
解決する課題
一般的に、Webhookは送信元(例: Stripe)から直接自社サーバーへ送信されます。しかし、以下のような原因で受信に失敗することがあります。
- 自社サーバーのデプロイや再起動による一時的なダウンタイム
- 想定外のトラフィック急増(スパイク)による
503 Service Unavailable - ネットワークの瞬断やDNSの解決エラー
Osiryn Relayを中間に挟むことで、これらのエラーが発生した場合でもデータは失われません。サーバーが復旧するまで自動的に再送(Exponential Backoff)を行い、最終的に確実にお届けします。
主な機能
| 機能 | 説明 |
|---|---|
| 自動リトライ | ターゲットサーバーがエラー(500番台)を返した場合、最大7回まで時間間隔を空けて再送します。 |
| 署名検証 (Signature Verification) | LINEやStripe等の各サービス固有の暗号化署名を検証し、不正なリクエストをブロックします。 |
| 詳細なログ | ヘッダー、ペイロード、応答コード、処理時間など、すべての送受信履歴をダッシュボードで確認できます。 |
| 障害アラート | 最大再送回数に達してしまったWebhook(Dead Letter)が発生した際、EmailまたはLINEで即時通知します。 |