Nieuw: Customer Webhooks voor PhotoRobot Cloud

Customer Webhooks voor PhotoRobot Cloud

Uw ontwikkelaars en IT-teams kunnen PhotoRobot Cloud nu koppelen aan uw DAM, PIM, ERP of maatwerkautomatisering via ondertekende uitgaande webhooks. Customer Webhooks in PhotoRobot Cloud zorgen voor betrouwbare, gebeurtenisgestuurde gegevenslevering – en daarmee voor volledige connectiviteit tussen uw studio en uw systemen.

‍

‍

‍

Sluit de cirkel tussen uw studio en uw systemen

Zorg dat uw downstreamsystemen weten wanneer de status van een item wijzigt of er zich een gebeurtenis voordoet met betrekking tot de beschikbaarheid van hosting. PhotoRobot Cloud Customer Webhooks leveren elke gebeurtenis af op uw endpoints, zodat integraties gebeurtenisgestuurd blijven – en niet op polling zijn gebaseerd.

De actieve gebeurtenissen zijn:

• item.status.changed – doorgevoerde wijziging van de opnamestatus van één item.
• item.status.bulk_changed — één gebeurtenis na een bulkstatuswijziging in Cloud.
• hosting.item.availability.changed — gehoste media zijn downloadbaar of niet meer beschikbaar geworden.
• webhook.subscription.test — alleen bij ‘Send test’.

‍

‍

‍

Betrouwbare, gebeurtenisgestuurde gegevenslevering

Customer Webhooks in PhotoRobot Cloud bieden functies voor:

• Uitgaande webhookabonnementen, beheerd naast uw developer-integraties.
• Ondertekende HTTP-levering, zodat ontvangers de authenticiteit kunnen verifiëren.
• ‘Send test’ en filters om het webhookabonnement en de verificatie van de handtekening te bevestigen.
• Leveringslogboek om de payload, de HTTP-status en nieuwe pogingen te inspecteren.
• Developer-UI onder Webhooks — webhooks en leveringen staan naast uw API-sleutels.

‍

‍

‍

Uw taal spreken voor productie-integraties

Customer Webhooks vormen de ontbrekende schakel tussen robotgestuurde opnames en de bronsystemen van uw bedrijf. De webhook is een ondertekend signaal met bewust kleine payloads. Na een 2xx-respons haalt de integratie het actuele item op via REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks kunnen een publisher op de hoogte stellen of – na het ophalen – uw team helpen een CDN-purge te starten of een marketplace-listing bij te werken. PhotoRobot Cloud spreekt nu uw taal voor productie-integraties.

‍

‍

‍

Eerst een signaal, dan ophalen

Payloads blijven bewust klein. Elke payload vermeldt de gebeurtenis, de organisatie en (indien relevant) het item, plus pull.itemUrl en pull.deltaUrl. Payloads bevatten geen afbeeldingsbestanden, volledige mapstructuren of een compleet productrecord.

Het patroon dat ontwikkelaars moeten implementeren is:

1. Ontvang de POST en verifieer X-PhotoRobot-Signature aan de hand van de ruwe body.
2. Geef snel een 2xx-respons terug — voer de DAM-import of de marketplace-update uit in uw eigen worker.
3. Dedupliceer op basis van de gebeurtenis-ID. Levering gebeurt minstens één keer (at-least-once).
4. Haal de actuele status op uit REST v2 hosting met behulp van de pull-URL’s.

Juist die scheiding maakt de integratie betrouwbaar. PhotoRobot wacht niet tot uw catalogusjob is afgerond, en uw systeem beschouwt een melding nooit als de catalogus zelf.

‍

‍

‍

Veelvoorkomende voorbeelden van Customer Webhooks in de praktijk

De meest voorkomende toepassingen van Customer Webhooks binnen het PhotoRobot-ecosysteem zijn:

• PIM- of DAM-synchronisatie. Abonneer u op hosting.item.availability.changed. Zodra gehoste media downloadbaar zijn, haalt u itemUrl op en werkt u het product bij: spins, stills en metadata in één keer.
• Marktplaatsvermelding. Filter hostingevents op ‘Became downloadable’. Publiceer of actualiseer de vermelding pas wanneer PhotoRobot de afbeeldingen daadwerkelijk kan leveren.
• Inzicht in het productiebord. Abonneer u op item.status.changed wanneer uw ERP- of QC-bord moet weten dat een item de status EDITED, APPROVED of PUBLISHED heeft gekregen, zelfs voordat hosting gereed is.
• Bulkupdates voor campagnes. Na een grote statuswijziging in Cloud ontvangt u één item.status.bulk_changed-event met een deltaUrl. Verwerk zo de betreffende set in één keer, in plaats van duizenden webhooks per item te verwachten.
• Cache- of CDN-invalidatie. Wanneer hosting overschakelt naar beschikbaar of niet beschikbaar, wist of vult u de paden die uw webshop al kent. De webhook is de trigger; de Hosting API is de bron van de nieuwe URL’s.

‍

‍

‍

Zo configureert u uw Customer Webhooks

Om Customer Webhooks voor PhotoRobot Cloud in te stellen, opent u uw PhotoRobot Account in de modus Developers en maakt u via Webhooks een webhookabonnement aan. Richt het abonnement vervolgens op uw staging-endpoint om de eerste levering te controleren.

‍

‍

1. Meld u aan bij PhotoRobot Account en open Developers → Webhooks.
2. Maak een webhook aan. Plak uw HTTPS-endpoint, geef het een interne naam en kies de gewenste events.
3. Kopieer het signing secret zodra het verschijnt. Het wordt eenmalig getoond, totdat u het roteert.
4. Klik op Send test. Controleer of webhook.subscription.test binnenkomt en de handtekening wordt geverifieerd.
5. Open Delivery log om de payload, de HTTP-status en de retries te bekijken.
6. Richt het eerste abonnement op een staging-endpoint.

‍

‍

Voor meer technische informatie, waaronder het developer contract en voorbeelden van handtekeningen, raadpleegt u PhotoRobot Developer Portal – Webhooks.

‍

‍