ご紹介:PhotoRobot Cloud向けのカスタマーウェブフック

PhotoRobotは、DAM、PIM、ERP、またはカスタム自動化を署名済みのアウトバウンドウェブフックと接続するためのカスタマーウェブフックをPhotoRobot Cloud向けに導入します。

時間を節約し、このページの内容を要約する

このページの概要を生成するツールを選択します。

PhotoRobot Cloudのカスタマーウェブフック

開発者やITチームは、署名済みのアウトバウンドウェブフックでPhotoRobot CloudをDAM、PIM、ERP、またはカスタム自動化に接続できます。PhotoRobot Cloudの顧客ウェブフックは、信頼性が高くイベント駆動型のデータ配信を提供し、スタジオとシステム間の完全な接続を保証します。

‍

‍

スタジオとシステムのループを閉じましょう

アイテムの状態が変わったり、ホスティングの可用性イベントが発生した場合、下流システムに確実に伝えてください。PhotoRobotクラウドのカスタマーウェブフックは、各イベントをエンドポイントに届け、統合がポーリングベースではなくイベント駆動型に保たれます。

ライブイベントは以下の通りです:

item.status.changed – 1つのアイテムでキャプチャ状態変更がコミットされました。
item.status.bulk_changed — クラウドの一括ステータス変更の1回後のイベント。
hosting.item.availability.changed — ホストされたメディアがダウンロード可能または利用不可になった。
webhook.subscription.test — テストのみ送信。

‍

‍

信頼性の高いイベント駆動型データ配信

PhotoRobot Cloudのカスタマーウェブフックには以下の機能が含まれます:

開発者連携と並行して管理されるアウトバウンドのウェブフックサブスクリプション。
受信者が真正性を検証できる署名付きHTTP配信。
「テストを送信」とウェブ フックのサブスクリプション確認と署名認証のフィルター。
ペイロード、HTTPステータス、再試行を検査するためのデリバリーログ。
Webhooksの開発者UI は、Webhookと配信がAPIキーの隣にライブ配信されています。

‍

‍

本番環境での統合のためのあなたの言語を話す

カスタマーWebhookは、ロボット化されたキャプチャと企業の記録システムの間に欠けているリンクです。webhookは署名付きシグナルで、意図的に小さなペイロードのみを運んでいます。2xx以降、統合はREST v2から現在のアイテムを取得します(pull.itemUrl / pull.deltaUrl)。Webhookはパブリッシャーに通知したり、プル後にチームがCDNのパージを開始したりマーケットプレイスの更新を行ったりするのを支援します。PhotoRobot Cloudは本番環境での統合のためにあなたの言語を話します。

‍

‍

合図、そして引っ張る

ペイロードは意図的に小さく保たれています。各ペイロードは イベント名、組織名、関連 時にはアイテム名、 さらにpull.itemUrl や pull.deltaUrlを名付けます。ペイロードはイメージバイナリ、完全なフォルダツリー、または完全な製品レコードを運び ません 。

開発者が実装すべきパターンは以下の通りです:

POSTを受け取り、X-PhotoRobot-Signatureを生のボディと照合してください。
2xxを素早く返品しましょう — 自分のワーカーでDAMインポートやマーケットプレイスのアップデートをしてください。
イベントIDで重複を排除します。配信は少なくとも一度だけです。
REST v2ホスティングからプルURLを使って現在の状態を取得します。

この分割こそが統合の信頼性を高めています。PhotoRobotはカタログ作業が完了するのを待たず、システムも通知をカタログとして扱いません。

‍

‍

顧客用ウェブフックの一般的な例

PhotoRobotエコシステムにおけるカスタマーウェブフックの最も一般的なユースケースは以下の通りです:

PIMまたはDAMの更新。 hosting.item.availability.changed に登録してください。ホストされたメディアがダウンロード可能になったら、itemUrlをプルして製品を更新してください — スピン、静止画、メタデータを一度に処理します。
マーケットプレイスのリスティング。イベントのホスティングを「ダウンロード可能になった」に絞り込みます。PhotoRobotが実際に画像を配信できるようになった後にのみリスティングを公開または更新してください。
本番ボードの可視化。 ERPやQCボードが、ホスティングが整う前からアイテムが編集済み、承認済み、公開済みに移行されたことを知らせる必要がある場合は、item.status.changedを購読してください。
一括キャンペーン更新。 クラウドで大きなステータス変更があった後、deltaURL付きのイベントitem.status.bulk_changedが届きます。1アイテムあたり何千ものウェブフックを期待する代わりに、影響を受けたイベントを追いつきましょう。
キャッシュまたはCDN無効化。 ホスティングが利用可能または不可に切り替わる際、ストアフロントが既に知っているパスをパーグまたはウォームしてください。ウェブフックがトリガーです。新しいURLのソースはホスティングAPIです。

‍