Neu: Customer Webhooks für PhotoRobot Cloud

Customer Webhooks für PhotoRobot Cloud

Ihre Entwickler und IT-Teams können PhotoRobot Cloud jetzt über signierte ausgehende Webhooks mit Ihrem DAM, PIM, ERP oder Ihrer individuellen Automatisierung verbinden. Customer Webhooks in PhotoRobot Cloud sorgen für eine zuverlässige, ereignisgesteuerte Datenübermittlung – und damit für eine vollständige Anbindung zwischen Ihrem Studio und Ihren Systemen.

‍

‍

‍

Schließen Sie den Kreis zwischen Studio und Systemen

Stellen Sie sicher, dass Ihre nachgelagerten Systeme erfahren, wenn sich der Status eines Elements ändert oder ein Ereignis zur Hosting-Verfügbarkeit eintritt. PhotoRobot Cloud Customer Webhooks übermitteln jedes Ereignis an Ihre Endpunkte, sodass Ihre Integrationen ereignisgesteuert bleiben – und nicht auf Polling basieren.

Folgende Live-Ereignisse stehen zur Verfügung:

• item.status.changed – bestätigte Änderung des Aufnahmestatus bei einem Artikel.
• item.status.bulk_changed – ein Ereignis nach einer Massenänderung des Status in Cloud.
• hosting.item.availability.changed – gehostete Medien sind herunterladbar geworden oder nicht mehr verfügbar.
• webhook.subscription.test – nur beim Senden eines Tests.

‍

‍

‍

Zuverlässige, ereignisgesteuerte Datenübermittlung

Customer Webhooks in PhotoRobot Cloud bieten Funktionen für:

• Ausgehende Webhook-Abonnements, verwaltet zusammen mit Ihren Entwickler-Integrationen.
• Signierte HTTP-Zustellung, damit Empfänger die Authentizität prüfen können.
• „Send test“ und Filter, um Webhook-Abonnement und Signaturprüfung zu bestätigen.
• Zustellprotokoll zur Einsicht von Payload, HTTP-Status und Wiederholungsversuchen.
• Entwickler-Oberfläche unter Webhooks – Webhooks und Zustellungen finden Sie direkt neben den API-Schlüsseln.

‍

‍

‍

Ihre Sprache für Produktivintegrationen

Customer Webhooks sind das fehlende Bindeglied zwischen robotergestützter Aufnahme und den führenden Systemen im Unternehmen. Der Webhook ist ein signiertes Signal, das bewusst nur kleine Payloads überträgt. Nach einer 2xx-Antwort ruft die Integration das aktuelle Element über REST v2 ab (pull.itemUrl / pull.deltaUrl). Webhooks können einen Publisher benachrichtigen oder – nach dem Abruf – Ihr Team dabei unterstützen, einen CDN-Purge auszulösen oder einen Marktplatzeintrag zu aktualisieren. PhotoRobot Cloud spricht jetzt Ihre Sprache, wenn es um Integrationen im Produktivbetrieb geht.

‍

‍

‍

Erst das Signal, dann der Abruf

Die Payloads bleiben bewusst klein. Jede Payload nennt das Ereignis, die Organisation und (falls relevant) den Artikel sowie pull.itemUrl und pull.deltaUrl. Payloads enthalten keine Bild-Binärdaten, vollständigen Ordnerstrukturen oder kompletten Produktdatensätze.

Entwickler sollten folgendes Muster umsetzen:

1. POST empfangen und X-PhotoRobot-Signature anhand des Rohdatenkörpers (Raw Body) prüfen.
2. Schnell 2xx zurückgeben – den DAM-Import oder das Marktplatz-Update in einem eigenen Worker ausführen.
3. Nach Ereignis-ID deduplizieren. Die Zustellung erfolgt mindestens einmal (at-least-once).
4. Den aktuellen Stand über die Pull-URLs aus dem REST-v2-Hosting abrufen.

Genau diese Trennung macht die Integration zuverlässig. PhotoRobot wartet nicht darauf, dass Ihr Katalogjob abgeschlossen ist, und Ihr System behandelt eine Benachrichtigung nie als den Katalog selbst.

‍

‍

‍

Typische Anwendungsbeispiele für Customer Webhooks

Zu den häufigsten Anwendungsfällen für Customer Webhooks im PhotoRobot-Ökosystem zählen:

• PIM- oder DAM-Aktualisierung. Abonnieren Sie hosting.item.availability.changed. Sobald gehostete Medien zum Download bereitstehen, rufen Sie itemUrl ab und aktualisieren das Produkt – Spins, Stills und Metadaten in einem Durchgang.
• Marktplatz-Listing. Filtern Sie Hosting-Ereignisse auf „Became downloadable“. Veröffentlichen oder aktualisieren Sie das Listing erst dann, wenn PhotoRobot die Bilder tatsächlich ausliefern kann.
• Transparenz im Produktionsboard. Abonnieren Sie item.status.changed, wenn Ihr ERP- oder QC-Board erfahren muss, dass ein Artikel auf EDITED, APPROVED oder PUBLISHED gesetzt wurde – noch bevor das Hosting bereit ist.
• Massenaktualisierung von Kampagnen. Nach einer umfangreichen Statusänderung in Cloud trifft ein einzelnes Ereignis item.status.bulk_changed mit einer deltaUrl ein. Gleichen Sie damit die betroffene Menge ab, statt Tausende Webhooks pro Artikel zu erwarten.
• Cache- oder CDN-Invalidierung. Wenn das Hosting auf verfügbar oder nicht verfügbar wechselt, leeren Sie die Pfade, die Ihr Shop bereits kennt, oder laden Sie sie vorab in den Cache. Der Webhook ist der Auslöser; die Hosting API liefert die neuen URLs.

‍

‍

‍

So konfigurieren Sie Ihre Customer Webhooks

Um Customer Webhooks für PhotoRobot Cloud einzurichten, öffnen Sie Ihr PhotoRobot Account im Developers-Modus und erstellen Sie unter „Webhooks“ ein Webhook-Abonnement. Richten Sie das Abonnement anschließend auf Ihren Staging-Endpunkt aus, um die erste Zustellung zu überprüfen.

‍

‍

1. Melden Sie sich bei PhotoRobot Account an und öffnen Sie Developers → Webhooks.
2. Erstellen Sie einen Webhook. Fügen Sie Ihren HTTPS-Endpunkt ein, vergeben Sie einen internen Namen und wählen Sie die benötigten Ereignisse aus.
3. Kopieren Sie das Signing Secret, sobald es angezeigt wird – es wird nur einmal angezeigt, bis Sie es rotieren.
4. Klicken Sie auf Send test. Prüfen Sie, ob webhook.subscription.test eintrifft und die Signatur verifiziert wird.
5. Öffnen Sie das Delivery log, um Payload, HTTP-Status und Wiederholungsversuche einzusehen.
6. Richten Sie das erste Abonnement auf einen Staging-Endpunkt aus.

‍

‍

Weitere technische Informationen, darunter Developer Contract und Signaturbeispiele, finden Sie im PhotoRobot Developer Portal – Webhooks.

‍

‍