Introduktion: Kundwebhooks för PhotoRobot Cloud

Kund-webhooks för PhotoRobot Cloud

Dina utvecklare och IT-team kan nu koppla PhotoRobot Cloud till din DAM, PIM, ERP eller anpassad automation med signerade utgående webhooks. Kundwebhooks i PhotoRobot Cloud erbjuder pålitlig, händelsedriven dataleverans – vilket säkerställer full anslutning mellan din studio och systemen.

‍

‍

‍

Stäng loopen mellan din studio och systemen

Se till att dina nedströmssystem vet när en artikelstatus ändras eller en hosting-tillgänglighetshändelse inträffar. PhotoRobot Cloud Customer Webhooks levererar varje händelse till dina endpoints så att integrationerna förblir händelsedrivna – inte polling-baserade.

Live-evenemangen är:

• Item.status.changed – genomförde en capture-statusändring på en artikel.
• item.status.bulk_changed — en händelse efter en bulkstatusändring i molnet.
• hosting.item.availability.changed — hostat media blev nedladdningsbart eller otillgängligt.
• webhook.subscription.test — Endast skicka test.

‍

‍

‍

Tillförlitlig, händelsedriven dataleverans

Kundwebhooks i PhotoRobot Cloud inkluderar funktioner för:

• Utgående webhook-prenumerationer hanteras tillsammans med dina utvecklarintegrationer.
• Signerad HTTP-leverans så att mottagare kan verifiera äkthet.
• "Skicka test" och filter för att bekräfta webhook-prenumeration och signaturverifiering.
• Leveranslogg för att inspektera nyttolasten, HTTP-status och omförsök.
• Utvecklargränssnitt under Webhooks — webhooks och leveranser live bredvid API-nycklar.

‍

‍

‍

Att tala ditt språk för produktionsintegrationer

Customer Webhooks är den saknade länken mellan robotiserad fångst och företagets registersystem. Webhooken är en signerad signal som medvetet bara bär små laster. Efter 2xx hämtar integrationen det aktuella objektet från REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks kan meddela en utgivare, eller efter dragningen underlätta för ditt team att starta en CDN-rensning eller uppdatera en marknadsplatsannons. PhotoRobot Cloud talar nu ditt språk för produktionsintegrationer.

‍

‍

‍

En signal, sedan en dragning

Payloads förblir medvetet små. Varje payload namnger händelsen, organisationen och (när relevant) objektet, plus pull.itemUrl och pull.deltaUrl. Payloads bär inte bildbinärer, fullständiga mappträd eller en komplett produktpost.

Mönsterutvecklarna bör implementera är:

1. Ta emot POST och verifiera X-PhotoRobot-Signature mot råkroppen.
2. Returnera 2xx snabbt — gör DAM-importen eller marknadsplatsuppdateringen i din egen arbetare.
3. Deduplicera efter händelse-ID. Leverans sker minst en gång.
4. Hämta det aktuella tillståndet från REST v2-hosting med hjälp av pull-URL:erna.

Den uppdelningen är det som gör integrationen pålitlig. PhotoRobot väntar inte på att ditt katalogjobb ska bli klart, och ditt system behandlar aldrig en notis som katalogen.

‍

‍

‍

Vanliga exempel på kundwebbhooks i bruk

De vanligaste användningsområdena för kundwebhooks i PhotoRobot-ekosystemet inkluderar:

• PIM eller DAM-uppdatering. Prenumerera på hosting.item.availability.changed. När hostat media blir nedladdningsbart, hämta itemUrl och uppdatera produkten — spinns, stillbilder och metadata i ett och samma pass.
• Marknadsplatsannons. Filtrera värdhändelser till "Blev nedladdningsbar." Publicera eller uppdatera annonsen först efter att PhotoRobot faktiskt kan visa bilderna.
• Synlighet i produktionsbrädet. Prenumerera på item.status.changed när din ERP- eller QC-tavla behöver veta att ett objekt flyttats till REDIGERAD, GODKÄND eller PUBLICERAD — även innan hosting är klar.
• Bulkuppdateringar av kampanjer. Efter en stor statusändring i Cloud anländer ett item.status.bulk_changed event med en deltaUrl. Ta igen den drabbade uppsättningen istället för att förvänta dig tusentals webhooks per föremål.
• Cache- eller CDN-ogiltigförklaring. När hosting byter till tillgänglig eller otillgänglig, rensa eller värm upp de vägar som din butik redan känner till. Webhooken är triggern; Hosting API är källan till de nya URL:erna.

‍

‍

‍

Hur du konfigurerar dina kund-webhooks

För att ställa in Customer Webhooks för PhotoRobot Cloud, öppna ditt PhotoRobot Account i utvecklarläge och använd Webhooks för att skapa en webhook-prenumeration. Peka sedan prenumerationen mot din staging-endpoint för att verifiera den första leveransen.

‍

‍

1. Logga in på PhotoRobot Account och öppna Utvecklare → 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 en gång tills du roterar den.
4. Klicka på Skicka test. Bekräfta att webhook.subscription.test anländer och signaturen verifieras.
5. Öppna leveranslogg för att inspektera nyttolasten, HTTP-status och omförsök.
6. Peka den första prenumerationen mot en staging-endpoint.

‍

‍

För mer teknisk information, inklusive exempel på utvecklarkontrakt och signaturer, se PhotoRobot Developer Portal – Webhooks.

‍

‍