Introductie: Customer Webhooks voor PhotoRobot Cloud

Klantwebhooks voor PhotoRobot Cloud

Je ontwikkelaars en IT-teams kunnen nu PhotoRobot Cloud verbinden met je DAM, PIM, ERP of aangepaste automatisering met ondertekende uitgaande webhooks. Klantwebhooks in PhotoRobot Cloud bieden betrouwbare, gebeurtenisgestuurde datalevering – wat volledige connectiviteit tussen je studio en systemen garandeert.

‍

‍

‍

Sluit de lus tussen je studio en systemen

Zorg ervoor dat je downstream-systemen weten wanneer de status van een item verandert of een hosting-beschikbaarheidsevent plaatsvindt. PhotoRobot Cloud Customer Webhooks leveren elk event naar je endpoints zodat integraties event-driven blijven – niet polling-gebaseerd.

De live-evenementen zijn:

• item.status.changed – Een capture-statuswijziging uitgevoerd op één item.
• item.status.bulk_changed — één gebeurtenis na een bulkstatuswijziging in de Cloud.
• hosting.item.availability.changed — gehoste media werden downloadbaar of niet meer beschikbaar.
• webhook.subscription.test — Alleen test verzenden.

‍

‍

‍

Betrouwbaar, gebeurtenisgestuurde datalevering

Customer Webhooks in PhotoRobot Cloud bevatten functies voor:

• Outbound webhook-abonnementen worden beheerd naast je ontwikkelaarsintegraties.
• Ondertekende HTTP-levering zodat ontvangers de authenticiteit kunnen verifiëren.
• "Test verzenden" en filters om webhook-abonnement en handtekeningverificatie te bevestigen.
• Delivery log om de payload, HTTP-status en herhalingen te inspecteren.
• Developer UI onder Webhooks — webhooks en leveringen live naast API-sleutels.

‍

‍

‍

Je taal spreken voor productie-integraties

Customer Webhooks zijn de ontbrekende schakel tussen gerobotiseerde capture en bedrijfssystemen van registratie. De webhook is een ondertekend signaal dat expres slechts kleine payloads draagt. Na 2xx haalt de integratie het huidige item uit REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks kunnen een uitgever informeren, of na de pull je team helpen bij het starten van een CDN-purge of het bijwerken van een marktplaatsvermelding. PhotoRobot Cloud spreekt nu jouw taal voor productie-integraties.

‍

‍

‍

Een signaal, dan een trek

Payloads blijven expres klein. Elke payload benoemt het event, de organisatie en (indien relevant) het item, plus pull.itemUrl en pull.deltaUrl. Payloads dragen geen image-binairs, volledige mapbomen of een volledig productrecord.

Het patroon dat ontwikkelaars moeten implementeren is:

1. Ontvang de POST en verifieer X-PhotoRobot-Signature met het ruwe lichaam.
2. Stuur 2xx snel terug — doe de DAM-import of marktplaatsupdate in je eigen werker.
3. Dedupliceren op event ID. Aflevering is minstens één keer mogelijk.
4. Haal de huidige status op van REST v2 hosting met behulp van de pull URL's.

Die splitsing maakt de integratie betrouwbaar. PhotoRobot wacht niet tot je cataloguswerk klaar is, en je systeem behandelt een melding nooit als de catalogus.

‍

‍

‍

Veelvoorkomende voorbeelden van Customer Webhooks in gebruik

De meest voorkomende gebruiksscenario's voor Customer Webhooks in het PhotoRobot-ecosysteem zijn onder andere:

• PIM- of DAM-ververs. Abonneer je op hosting.item.availability.changed. Wanneer gehoste media downloadbaar is, haal je itemUrl op en werk je het product bij — spins, stills en metadata in één doorgang.
• Marktplaatsvermelding. Filter hostingevenementen op "Werd downloadbaar." Publiceer of werk de vermelding pas bij nadat PhotoRobot de afbeeldingen daadwerkelijk kan tonen.
• Zichtbaarheid van het productiebord. Abonneer je op item.status.changed wanneer je ERP- of QC-bord moet weten dat een item is verplaatst naar EDITED, APPROVED of PUBLISHED — zelfs voordat hosting klaar is.
• Bulk-campagne-updates. Na een grote statuswijziging in de Cloud arriveert er één item.status.bulk_changed event met een deltaUrl. Haal de getroffen set in plaats van duizenden webhooks per item te verwachten.
• Cache of CDN-ongeldigmaking. Wanneer hosting omschakelt naar beschikbaar of niet-beschikbaar, maak dan de paden die je winkelfront al kent schoon of verwarm. De webhook is de trigger; Hosting API is de bron van de nieuwe URL's.

‍

‍

‍

Hoe je je klantenwebhooks configureert

Om Customer Webhooks voor PhotoRobot Cloud in te stellen, open je je PhotoRobot-account in Developers-modus en gebruik je Webhooks om een webhook-abonnement aan te maken. Richt het abonnement vervolgens op je staging-endpoint om de eerste levering te verifiëren.

‍

‍

1. Log in op PhotoRobot account en open Ontwikkelaars → Webhooks.
2. Maak een webhook aan. Plak je HTTPS-endpoint, geef het een interne naam en kies de events die je nodig hebt.
3. Kopieer het signeergeheim zodra het verschijnt — het wordt één keer getoond totdat je het roteert.
4. Klik op Test verzenden. Bevestig dat webhook.subscription.test arriveert en de handtekening wordt bevestigd.
5. Open Delivery-log om de payload, HTTP-status en herpogingen te inspecteren.
6. Richt het eerste abonnement op een staging-endpoint.

‍

‍

Voor meer technische informatie, waaronder voorbeelden van ontwikkelaarscontracten en handtekeningen, zie PhotoRobot Developer Portal – Webhooks.

‍

‍