Webhooksとは？
Webhookにより、Mercateerのフロントオフィスイベントがリアルタイムでお客様が管理するURLにプッシュされるため、APIをポーリングせずに自社システムが反応できます。各配信はHMACで署名されたJSONペイロードであり、エンドポイントはAPIまたはダッシュボードから登録・管理できます。配信失敗時にはバックオフ付きで再試行されます。
Webhooksでできること
数分でインストール
エンドポイントを作成
APIまたは［設定］→［開発者］からURLを登録し、購読するイベントを選択してください。Mercateerはそのエンドポイント用の署名シークレットを返却します。APIアクセスはCrewプランおよびFleetプランに含まれています。
署名を検証
IntegrationPages.On every delivery, read the timestamp (t) and signature (v1) from the signature header, then compute the HMAC-SHA256 of the string "{timestamp}_{raw request body}" with your signing secret and compare it to the v1 value_ Reject any request that does not match, or whose timestamp is more than 5 minutes old, so you only act on fresh payloads that truly came from Mercateer_ (Our SDK’s verify helper does all of this for you_)
再試行をべき等性（idempotent）で処理
配信を迅速に2xxで応答して受領を通知してください。失敗した配信はバックオフ付きで再試行されるため、ハンドラーはイベントIDをキーにして重複を無視し、各イベントを一度だけ処理するようにしてください。
よくある質問
既存のツール群と完全連携
Mercateerは、すでにご利用中のツールと同じプロトコルで動作します。