Vorstellung: Kunden-Webhooks für PhotoRobot Cloud

Kunden-Webhooks für PhotoRobot Cloud

Ihre Entwickler und IT-Teams können PhotoRobot Cloud jetzt mit Ihrem DAM, PIM, ERP oder individueller Automatisierung mit signierten Outbound-Webhooks verbinden. Kunden-Webhooks in PhotoRobot Cloud bieten zuverlässige, ereignisgesteuerte Datenübertragung – und stellen eine vollständige Konnektivität zwischen Ihrem Studio und Ihren Systemen sicher.

‍

‍

‍

Schließe die Schleife zwischen deinem Studio und deinem System

Stellen Sie sicher, dass Ihre nachgelagerten Systeme wissen, wann sich der Status eines Artikels ändert oder ein Hosting-Verfügbarkeitsereignis auftritt. PhotoRobot Cloud Customer Webhooks liefern jedes Ereignis an Ihre Endpunkte, sodass die Integrationen ereignisgesteuert bleiben – nicht auf Umfragen.

Die Live-Events sind:

• Item.status.changed – Ergriffsstatusänderung bei einem Item durchgeführt.
• item.status.bulk_changed – ein Ereignis nach einer Cloud-Massenstatusänderung.
• hosting.item.availability.changed — gehostete Medien wurden herunterladbar oder nicht mehr verfügbar.
• webhook.subscription.test — Nur Test senden.

‍

‍

‍

Zuverlässige, ereignisgesteuerte Datenbereitstellung

Kunden-Webhooks in PhotoRobot Cloud umfassen Funktionen für:

• Outbound Webhook-Abonnements werden zusammen mit Ihren Entwicklerintegrationen verwaltet.
• Signierte HTTP-Zustellung , damit Empfänger die Echtheit überprüfen können.
• "Test senden" und Filter, um das Webhook-Abonnement und die Signaturverifizierung zu bestätigen.
• Lieferprotokoll zur Inspektion der Nutzlast, des HTTP-Status und der erneuten Versuche.
• Entwickler-UI unter Webhooks – Webhooks und Lieferungen direkt neben API-Schlüsseln.

‍

‍

‍

Sprache sprechen für Produktionsintegrationen

Kunden-Webhooks sind das fehlende Bindeglied zwischen robotisierter Erfassung und Unternehmenssystemen. Der Webhook ist ein signiertes Signal, das absichtlich nur kleine Nutzlasten transportiert. Nach 2xx zieht die Integration das aktuelle Element aus REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks können einen Publisher benachrichtigen oder nach dem Pull Ihr Team dabei unterstützen, eine CDN-Säuberung zu starten oder eine Marktplatzliste zu aktualisieren. PhotoRobot Cloud spricht jetzt Ihre Sprache für Produktionsintegrationen.

‍

‍

‍

Ein Signal, dann ein Zug

Payloads bleiben absichtlich klein. Jede Payload nennt das Ereignis, die Organisation und (wenn relevant) das Element sowie pull.itemUrl und pull.deltaUrl. Payloads enthalten keine Bildbinär, keine vollständigen Ordnerbäume oder einen vollständigen Produkteintrag.

Die Pattern-Entwickler sollten implementieren:

1. Erhalten Sie das POST und verifizieren Sie X-PhotoRobot-Signature mit dem Rohkörper.
2. Gib 2xx schnell zurück – führe den DAM-Import oder das Marktplatz-Update in deinem eigenen Arbeiter durch.
3. Deduplizieren nach Ereignis-ID. Die Lieferung erfolgt mindestens einmal.
4. Holen Sie den aktuellen Zustand aus dem REST v2-Hosting mit den Pull-URLs.

Diese Aufteilung macht die Integration zuverlässig. PhotoRobot wartet nicht darauf, dass Ihre Katalogarbeit abgeschlossen ist, und Ihr System behandelt eine Benachrichtigung nie als Katalog.

‍

‍

‍

Häufige Beispiele für Kunden-Webhooks im Einsatz

Die häufigsten Anwendungsfälle für Customer Webhooks im PhotoRobot-Ökosystem umfassen:

• PIM- oder DAM-Aktualisierung. Abonnieren Sie hosting.item.availability.changed. Wenn gehostete Medien herunterladbar sind, ziehen Sie itemUrl und aktualisieren Sie das Produkt – Drehungen, Standbilder und Metadaten in einem Durchgang.
• Marktplatz-Listing. Filtern Sie die Hosting-Events auf "Wurde herunterladbar". Veröffentlichen oder aktualisieren Sie das Angebot erst, nachdem PhotoRobot die Bilder tatsächlich bereitstellen kann.
• Sichtbarkeit des Produktionsboards. Abonnieren Sie item.status.changed, wenn Ihr ERP- oder QC-Board wissen muss, dass ein Element auf EDITED, APPROVED oder PUBLISHED verschoben wurde – noch bevor das Hosting bereit ist.
• Massen-Kampagnen-Updates. Nach einer großen Statusänderung in der Cloud erscheint ein item.status.bulk_changed Event mit einer deltaUrl. Holen Sie die betroffenen Sets auf, anstatt Tausende von Webhooks pro Artikel zu erwarten.
• Cache- oder CDN-Ungültigkeit. Wenn das Hosting auf verfügbar oder nicht verfügbar wechselt, löschen oder erwärmen Sie die Pfade, die Ihr Storefront bereits kennt. Der Webhook ist der Auslöser; Die Hosting-API ist die Quelle der neuen URLs.

‍

‍

‍

Wie Sie Ihre Kunden-Webhooks konfigurieren

Um Customer Webhooks für PhotoRobot Cloud einzurichten, öffnen Sie Ihr PhotoRobot-Konto im Entwicklermodus und verwenden Sie Webhooks, um ein Webhook-Abonnement zu erstellen. Anschließend richten Sie das Abonnement auf Ihren Staging-Endpunkt, um die erste Lieferung zu überprüfen.

‍

‍

1. Melden Sie sich in PhotoRobot Konto an und öffnen Sie Entwickler → Webhooks.
2. Erstellen Sie einen Webhook. Fügen Sie Ihren HTTPS-Endpunkt ein, geben Sie ihm einen internen Namen und wählen Sie die benötigten Ereignisse aus.
3. Kopiere das Signiergeheimnis, sobald es erscheint – es wird einmal angezeigt, bis du es rotierst.
4. Klicke auf Test senden. Bestätigen Sie, dass webhook.subscription.test ankommt und die Signatur bestätigt wird.
5. Öffne das Delivery-Logbuch , um die Nutzlast, den HTTP-Status und die erneuten Versuche zu überprüfen.
6. Richte das erste Abonnement auf einen Staging-Endpunkt.

‍

‍

Weitere technische Informationen, einschließlich Beispiele für Entwicklerverträge und Unterschriften, finden Sie im PhotoRobot Developer Portal – Webhooks.

‍

‍