お知らせのWebhookに対応

お知らせ外部連携用にWebhook設定を追加しました

Webhookとは

お知らせの更新(登録,更新,削除)のタイミングで外部システムが公開するHTTPエンドポイントに、更新イベントをHTTPのPOSTメソッドで通知します。

お知らせのWebhookで送信されるデータ

Webhookの呼び出しは、以下のようにHTTP/1.1で行われます。

送信データはガイドを参照してください。

POST {URLに含まれるパス} HTTP/1.1
Host: {URLのホストパート}
Content-Type: application/json; charset=utf-8

{
　:
}

Webhookで発行されたtokenの検証

セッション操作APIで、Webhookを生成した発行元が正しいものであるか確認することができます。

• 呼び出しURL

https://your-domain/h2/STRSessionManipurator.do

• リクエスト

パラメータ名	意味	必須	制約
func	動作モード	○	validateWebhookTokenを指定します。
key	WebAPIキー	○	セッション操作APIが利用可能なWebAPIキーを指定します。
token	トークン	○	Webhookで発行されたTokenを指定します。

 

Webhookを設定してみよう

• システムの管理権限が必要となります
• 注意 :  事前にWebhook通知を受けるエンドポイント、プログラムをご準備ください  
  関係の無いURLを登録すると、お知らせに登録された情報が漏れる可能性がございます。

1. [ システムの管理 ] > [ 連携アプリの設定 ] > [ Webhookを設定 ] を開く

2. [ Webhookを追加 ]ボタンを押下

3. [ ペイロードURL ] を設定する

   

   項目	説明
   ペイロードURL	外部アプリケーションへ通知するURLを設定する

4. [ 保存する ]ボタンを 押下し、設定を保存する

　 以上で、Webhookの設定は完了です。

Webhookで通知してみよう

• お知らせのWebhookを設定して実施してください

お知らせを公開する

お知らせの公開時にWebhook通知が送られます。

お知らせをメンテナンスする

公開済みのお知らせのメンテナンス時にWebhook通知が送られます。

お知らせを削除する

お知らせの削除時にWebhook通知が送られます。
お知らせの公開承認機能を利用している場合はお知らせの削除承認時に送られます。

Webhookの履歴を確認しよう

• システムの管理権限が必要となります

1. [ システムの管理 ] > [ 連携アプリの設定 ] > [ Webhookの履歴 ] を開く

　下記の情報を、Webhookの履歴画面から確認することができます。

• Webhook通知された時間
• 更新があったお知らせ
• Webbhook通知のステータスコード
• Webhook通知されたペイロードURL

 

また、右端にある"</>"を押下すると、HTTP request/response情報が確認できます。

 

2019年秋バージョン新機能ガイドの記事

• 2019年秋バージョン新機能ガイド
• お知らせのWebhookに対応
• お知らせ送り先の展開保持オプションを追加
• フォトスストックにフォトレポート・売場ノート連携オプションを追加
• その他の機能