Nyhet: Customer Webhooks för PhotoRobot Cloud

Customer Webhooks för PhotoRobot Cloud

Dina utvecklare och IT-team kan nu koppla ihop PhotoRobot Cloud med ditt DAM, PIM, ERP eller din egen automation via signerade utgående webhooks. Customer Webhooks i PhotoRobot Cloud ger tillförlitlig, händelsestyrd dataleverans – och full anslutning mellan din studio och dina system.

‍

‍

‍

Slut cirkeln mellan din studio och dina system

Se till att dina efterföljande system får veta när en artikels status ändras eller när en händelse inträffar som rör tillgänglighet för hostad media. Customer Webhooks i PhotoRobot Cloud levererar varje händelse till dina endpoints, så att integrationerna förblir händelsestyrda – inte baserade på polling.

Följande händelser är live:

• item.status.changed – bekräftad ändring av fotograferingsstatus för en enskild artikel.
• item.status.bulk_changed – en händelse efter en massändring av status i Cloud.
• hosting.item.availability.changed – hostad media har blivit nedladdningsbar eller otillgänglig.
• webhook.subscription.test – skickas endast via ”Send test”.

‍

‍

‍

Tillförlitlig, händelsestyrd dataleverans

Customer Webhooks i PhotoRobot Cloud omfattar funktioner för:

• Utgående webhook-prenumerationer som hanteras tillsammans med dina utvecklarintegrationer.
• Signerad HTTP-leverans så att mottagarna kan verifiera äktheten.
• ”Send test” och filter för att bekräfta webhook-prenumerationen och signaturverifieringen.
• Leveranslogg för att granska payload, HTTP-status och omförsök.
• Utvecklargränssnitt under Webhooks – webhooks och leveranser finns bredvid API-nycklarna.

‍

‍

‍

Vi talar ditt språk i produktionsintegrationer

Customer Webhooks är den saknade länken mellan robotstyrd fotografering och företagets system of record. Webhooken är en signerad signal som med avsikt bara innehåller små payloads. Efter 2xx hämtar integrationen den aktuella artikeln från REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks kan meddela en publiceringstjänst eller, efter hämtningen, hjälpa ditt team att starta en CDN-purge eller uppdatera en annons på en marknadsplats. PhotoRobot Cloud talar nu ditt språk i produktionsintegrationer.

‍

‍

‍

Först en signal, sedan en hämtning

Payloads hålls små med avsikt. Varje payload anger händelsen, organisationen och (när det är relevant) artikeln, samt pull.itemUrl och pull.deltaUrl. Payloads innehåller inte bildfiler, kompletta mappträd eller en fullständig produktpost.

Det mönster som utvecklare bör implementera är:

1. Ta emot POST-anropet och verifiera X-PhotoRobot-Signature mot den råa body.
2. Returnera 2xx snabbt – utför DAM-importen eller uppdateringen på marknadsplatsen i din egen worker.
3. Deduplicera på händelse-ID. Leveransen sker minst en gång (at-least-once).
4. Hämta aktuellt tillstånd från REST v2 hosting med hjälp av pull-URL:erna.

Den uppdelningen gör integrationen tillförlitlig. PhotoRobot väntar inte på att ditt katalogjobb ska bli klart, och ditt system behandlar aldrig en notifiering som själva katalogen.

‍

‍

‍

Vanliga exempel på hur Customer Webhooks används

De vanligaste användningsfallen för Customer Webhooks i PhotoRobot-ekosystemet är bland annat:

• Uppdatering av PIM eller DAM. Prenumerera på hosting.item.availability.changed. När hostad media blir nedladdningsbar hämtar du itemUrl och uppdaterar produkten – spins, stillbilder och metadata i ett enda steg.
• Produktlistning på marknadsplatser. Filtrera hosting-händelser på ”Became downloadable”. Publicera eller uppdatera listningen först när PhotoRobot faktiskt kan leverera bilderna.
• Överblick över produktionsflödet. Prenumerera på item.status.changed när ditt ERP- eller QC-system behöver veta att ett item har flyttats till EDITED, APPROVED eller PUBLISHED – även innan hostingen är klar.
• Massuppdateringar för kampanjer. Efter en stor statusändring i Cloud skickas en enda item.status.bulk_changed-händelse med en deltaUrl. Synka de berörda objekten i stället för att vänta dig tusentals webhooks per item.
• Cache- eller CDN-invalidering. När hosting växlar till tillgänglig eller otillgänglig rensar eller förvärmer du de sökvägar som din webbutik redan känner till. Webhooken är triggern; Hosting API är källan till de nya URL:erna.

‍

‍

‍

Så konfigurerar du dina Customer Webhooks

För att ställa in Customer Webhooks för PhotoRobot Cloud öppnar du ditt PhotoRobot Account i Developers mode och använder Webhooks för att skapa en webhook-prenumeration. Rikta sedan prenumerationen mot din stagingendpoint för att verifiera den första leveransen.

‍

‍

1. Logga in på PhotoRobot Account och öppna Developers → Webhooks.
2. Skapa en webhook. Klistra in din HTTPS-endpoint, ge den ett internt namn och välj de händelser du behöver.
3. Kopiera signeringshemligheten när den visas – den visas bara en gång, tills du roterar den.
4. Klicka på Send test. Kontrollera att webhook.subscription.test kommer fram och att signaturen verifieras.
5. Öppna Delivery log för att granska payload, HTTP-status och nya försök.
6. Rikta den första prenumerationen mot en stagingendpoint.

‍

‍

Mer teknisk information, bland annat om developer contract och signaturexempel, hittar du i PhotoRobot Developer Portal – Webhooks.

‍

‍