---
search:
  tags:
    - 変更通知
    - PUT
seo:
  description: 在庫が変わったときに通知するURLを登録します。通知に在庫の中身は載せないので、受け取ったら /inventory/changes…
sidebar:
  label: Webhookを登録する
  badge: PUT
title: Webhookを登録する
type: openapi-operation
---
在庫が変わったときに通知するURLを登録します。通知に在庫の中身は載せないので、受け取ったら `/inventory/changes` を読んでください。呼ぶたびに新しい署名用シークレットが返ります。URLはhttpsで、戻り先URLのどれかと同じオリジンにします。

通知は `POST url` で、本文は `{"type":"inventory.changed","tenantId","connectionId","occurredAt"}` です。`X-TorecaCloud-Signature: v1=<hex>` は、シークレット文字列をキーにした `HMAC-SHA256("<X-TorecaCloud-Timestamp>.<本文>")` です。時刻が300秒以上ずれた通知は拒否してください。

`PUT /webhook`