Nyhed: Customer Webhooks til PhotoRobot Cloud
PhotoRobot lancerer Customer Webhooks til PhotoRobot Cloud, så du kan forbinde dit DAM-, PIM- eller ERP-system eller din egen automatisering via signerede udgående webhooks.
Customer Webhooks til PhotoRobot Cloud
Dine udviklere og IT-teams kan nu forbinde PhotoRobot Cloud med dit DAM, PIM, ERP eller din egen automatisering via signerede udgående webhooks. Customer webhooks i PhotoRobot Cloud giver pålidelig, hændelsesstyret datalevering og sikrer fuld forbindelse mellem dit studie og dine systemer.
Luk kredsløbet mellem dit studie og dine systemer
Sørg for, at dine efterfølgende systemer får besked, når en vares status ændres, eller en hændelse vedrørende hosting-tilgængelighed opstår. PhotoRobot Cloud Customer Webhooks leverer hver hændelse til dine endpoints, så dine integrationer forbliver hændelsesstyrede – ikke baseret på polling.
De aktive hændelser er:
- item.status.changed – bekræftet ændring af optagelsesstatus på én vare.
- item.status.bulk_changed – én hændelse efter en samlet statusændring i Cloud.
- hosting.item.availability.changed – hostet medie er blevet tilgængeligt til download eller utilgængeligt.
- webhook.subscription.test – kun ved »Send test«.
Pålidelig, hændelsesstyret datalevering
Customer Webhooks i PhotoRobot Cloud omfatter funktioner til:
- Udgående webhook-abonnementer, der administreres sammen med dine udviklerintegrationer.
- Signeret HTTP-levering, så modtagere kan verificere ægtheden.
- »Send test« og filtre til at bekræfte webhook-abonnement og signaturverificering.
- Leveringslog til at kontrollere payload, HTTP-status og gentagne forsøg.
- Udviklergrænseflade under Webhooks – webhooks og leveringer findes ved siden af API-nøgler.
Vi taler dit sprog i produktionsintegrationer
Customer Webhooks er det manglende led mellem robotstøttet optagelse og virksomhedens systemer. Webhooken er et signeret signal, der med vilje kun indeholder små payloads. Efter 2xx henter integrationen den aktuelle vare fra REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks kan give besked til en publisher eller, efter hentningen, hjælpe dit team med at igangsætte en CDN-purge eller opdatere en marketplace-annonce. PhotoRobot Cloud taler nu dit sprog i produktionsintegrationer.
Først et signal, så en hentning
Payloads er med vilje små. Hver payload angiver hændelsen, organisationen og (når det er relevant) varen samt pull.itemUrl og pull.deltaUrl. Payloads indeholder ikke billedfiler, komplette mappetræer eller en fuldstændig produktpost.
Udviklere bør implementere følgende mønster:
- Modtag POST-anmodningen, og verificér X-PhotoRobot-Signature mod den rå body.
- Returnér hurtigt 2xx – udfør DAM-importen eller marketplace-opdateringen i din egen worker.
- Dedupliker efter hændelses-ID. Levering sker mindst én gang (at-least-once).
- Hent den aktuelle tilstand fra REST v2-hosting via pull-URL'erne.
Netop den opdeling gør integrationen pålidelig. PhotoRobot venter ikke på, at dit katalogjob bliver færdigt, og dit system behandler aldrig en notifikation som selve kataloget.
Typiske eksempler på brug af Customer Webhooks
De mest almindelige anvendelser af Customer Webhooks i PhotoRobot-økosystemet er bl.a.:
- Opdatering af PIM eller DAM. Abonnér på hosting.item.availability.changed. Når hostet media kan downloades, henter du itemUrl og opdaterer produktet – spins, stillbilleder og metadata i ét gennemløb.
- Markedspladsannoncer. Filtrer hosting-events til »Became downloadable«. Udgiv eller opdatér annoncen først, når PhotoRobot rent faktisk kan levere billederne.
- Overblik over produktionstavlen. Abonnér på item.status.changed, når dit ERP- eller QC-board skal vide, at et item er skiftet til EDITED, APPROVED eller PUBLISHED – selv før hosting er klar.
- Masseopdateringer til kampagner. Efter en stor statusændring i Cloud ankommer der én item.status.bulk_changed-event med en deltaUrl. Opdatér det berørte sæt i stedet for at vente på tusindvis af webhooks pr. item.
- Invalidering af cache eller CDN. Når hosting skifter til tilgængelig eller utilgængelig, kan du rydde eller forvarme de stier, som din webshop allerede kender. Webhooken er triggeren; Hosting API er kilden til de nye URL'er.
Sådan konfigurerer du dine Customer Webhooks
For at opsætte Customer Webhooks til PhotoRobot Cloud skal du åbne din PhotoRobot Account i Developers mode og bruge Webhooks til at oprette et webhook-abonnement. Peg derefter abonnementet mod dit staging-endpoint for at verificere den første levering.
- Log ind på PhotoRobot Account, og åbn Developers → Webhooks.
- Opret en webhook. Indsæt dit HTTPS-endpoint, giv det et internt navn, og vælg de events, du har brug for.
- Kopiér signeringshemmeligheden, når den vises – den vises kun én gang, indtil du roterer den.
- Klik på Send test. Bekræft, at webhook.subscription.test ankommer, og at signaturen bliver verificeret.
- Åbn Delivery log for at se payload, HTTP-status og gensendelser.
- Peg det første abonnement mod et staging-endpoint.
Du kan finde flere tekniske oplysninger, bl.a. developer contract og signatureksempler, i PhotoRobot Developer Portal – Webhooks.
