メディアを変更（作成／更新／削除）したタイミングで、Webhook通知を行うことができます。
「メディア管理」→「メディア設定」から設定可能です。
各Webhookの設定時にWebhookを発行するタイミングを設定できます。
管理画面でメディアを新規作成（新規アップロード）したときに通知を行います。
以下の場合は、Webhook通知は送信されません。ご注意ください。
管理画面でメディアを再アップロードしたとき／ファイル名を変更したときに通知を行います。
以下の場合は、Webhook通知は送信されません。ご注意ください。
管理画面でメディアを削除したときに通知を行います。
以下の場合は、Webhook通知は送信されません。ご注意ください。
メディアのWebhook通知では、任意のURLに対してPOSTリクエストを送信します。リクエストを受け取った先にて、独自の処理を行うことが可能です。
リクエストヘッダには Content-Type: application/json が含まれます。
リクエストボディには対象となったコンテンツやAPIの情報が含まれます。
{
"service": "someId",
"type": "edit",
"old": {
"url": "https://images.microcms-assets.io/assets/xxxx/yyyy/zzzz.jpg",
"width": 100,
"height": 100,
"alt": "Some sample alt text."
},
"new": {
"url": "https://images.microcms-assets.io/assets/xxxx/yyyy/zzzz.jpg",
"width": 100,
"height": 100,
"alt": "Some sample alt text."
},
}変更のあったメディアが属するサービスのサブドメインが入ります。
変更の種類です。新規追加時はnew、編集時はedit、削除時はdeleteが入ります。
メディアの編集前もしくは削除前の内容が含まれます。メディアの新規作成時にはnullが入ります。
メディアの作成後もしくは編集後の内容が含まれます。メディアの削除時にはnullが入ります。
メディアのurlが含まれます。
メディアのwidthが含まれます。画像以外のファイルの場合はnullが入ります。
メディアのheightが含まれます。画像以外のファイルの場合はnullが入ります。
メディアの管理画面から設定した代替テキストが含まれます。設定がない場合や画像以外のファイルの場合は、キー自体が含まれません。
microCMSからの通知を受け取るサーバは、一般公開をしておく必要があります。
そのため処理によっては、第三者からPOSTリクエストを受ける可能性も考慮した対応を行う必要があります。
具体的には、URLの設定時に?auth=XXX などmicroCMSと受け取り側サーバにしか知り得ない値を設定しておき、受け取り側のサーバでこの値が正しいかどうか（≒microCMSからのリクエストであるか否か）検証を行う方法が考えられます。
コンテンツのWebhookと同様に、Webhookリクエストのヘッダに署名値（Signature）を付与する対応については、検討を進めています。
Webhookの通知が、ネットワークエラーや4xx、5xxエラーにて失敗した場合でも、リトライ処理は行われません。
Webhookの通知は、設定したタイミングにつき1回のみ行われます。
原則として、Webhookの通知は操作の実行順に行われます。
ただし、厳密な制御は行われていないため、順序は保証されません。
Webhookの送信元IPアドレスは、動的IPアドレスです。
また、IPアドレスの範囲も公開しておりません。