Nyhet: Customer Webhooks for PhotoRobot Cloud

Kundespesifikke webhooks for PhotoRobot Cloud

Utviklerne og IT-teamene dine kan nå koble PhotoRobot Cloud til DAM, PIM, ERP eller egen automatisering via signerte utgående webhooks. Customer webhooks i PhotoRobot Cloud gir pålitelig, hendelsesstyrt dataoverføring – og sikrer full tilkobling mellom studioet og systemene dine.

‍

‍

‍

Knytt studioet og systemene dine tettere sammen

Sørg for at systemene downstream får beskjed når en vare endrer status, eller når en hendelse knyttet til hostingtilgjengelighet inntreffer. Customer Webhooks i PhotoRobot Cloud leverer hver hendelse til endepunktene dine, slik at integrasjonene forblir hendelsesstyrte – ikke basert på polling.

Følgende hendelser er aktive:

• item.status.changed – bekreftet endring av opptaksstatus for én vare.
• item.status.bulk_changed — én hendelse etter en samlet statusendring i Cloud.
• hosting.item.availability.changed — hostet media ble tilgjengelig for nedlasting eller utilgjengelig.
• webhook.subscription.test — Kun for «Send test».

‍

‍

‍

Pålitelig, hendelsesstyrt dataoverføring

Customer Webhooks i PhotoRobot Cloud inneholder funksjoner for:

• Abonnementer på utgående webhooks som administreres sammen med utviklerintegrasjonene dine.
• Signert HTTP-levering slik at mottakere kan verifisere at avsenderen er ekte.
• «Send test» og filtre for å bekrefte webhook-abonnementet og signaturverifiseringen.
• Leveringslogg for å inspisere payload, HTTP-status og nye forsøk.
• Utvikler-UI under Webhooks — webhooks og leveranser finner du ved siden av API-nøklene.

‍

‍

‍

Vi snakker språket ditt i produksjonsintegrasjoner

Customer Webhooks er det manglende leddet mellom robotisert opptak og selskapets kildesystemer. Webhooken er et signert signal som med vilje bare bærer små payloads. Etter 2xx henter integrasjonen den aktuelle varen fra REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks kan varsle en utgiver eller, etter hentingen, hjelpe teamet ditt med å starte en CDN-purge eller oppdatere en markedsplassoppføring. PhotoRobot Cloud snakker nå språket ditt i produksjonsintegrasjoner.

‍

‍

‍

Først et signal, deretter henting

Payloads holdes med vilje små. Hver payload oppgir hendelsen, organisasjonen og (når det er relevant) varen, i tillegg til pull.itemUrl og pull.deltaUrl. Payloads inneholder ikke bildebinærfiler, fullstendige mappetrær eller en komplett produktpost.

Mønsteret utviklere bør implementere, er:

1. Motta POST-forespørselen og verifiser X-PhotoRobot-Signature mot den rå body-en.
2. Returner 2xx raskt — gjør DAM-importen eller markedsplassoppdateringen i din egen worker.
3. Dedupliser på hendelses-ID. Levering skjer minst én gang (at-least-once).
4. Hent gjeldende tilstand fra REST v2-hosting ved hjelp av pull-URL-ene.

Denne delingen er det som gjør integrasjonen pålitelig. PhotoRobot venter ikke på at katalogjobben din skal bli ferdig, og systemet ditt behandler aldri et varsel som om det var selve katalogen.

‍

‍

‍

Vanlige eksempler på bruk av Customer Webhooks

De vanligste bruksområdene for Customer Webhooks i PhotoRobot-økosystemet er blant annet:

• Oppdatering av PIM eller DAM. Abonner på hosting.item.availability.changed. Når hostede medier blir tilgjengelige for nedlasting, henter du itemUrl og oppdaterer produktet – spinn, stillbilder og metadata i én operasjon.
• Markedsplassoppføring. Filtrer hosting-hendelser på «Became downloadable». Publiser eller oppdater oppføringen først når PhotoRobot faktisk kan levere bildene.
• Innsyn i produksjonsstatus. Abonner på item.status.changed når ERP- eller QC-tavlen din må vite at et element er flyttet til EDITED, APPROVED eller PUBLISHED – selv før hostingen er klar.
• Masseoppdateringer av kampanjer. Etter en stor statusendring i Cloud kommer én item.status.bulk_changed-hendelse med en deltaUrl. Synkroniser det berørte settet i stedet for å vente på tusenvis av webhooks per element.
• Invalidering av cache eller CDN. Når hosting går over til tilgjengelig eller utilgjengelig, kan du tømme eller forhåndsvarme URL-stiene nettbutikken din allerede kjenner. Webhooken er utløseren, mens Hosting API er kilden til de nye URL-ene.

‍

‍

‍

Slik konfigurerer du Customer Webhooks

For å sette opp Customer Webhooks for PhotoRobot Cloud åpner du PhotoRobot Account i Developers-modus og bruker Webhooks til å opprette et webhook-abonnement. Pek deretter abonnementet mot staging-endepunktet ditt for å verifisere den første leveransen.

‍

‍

1. Logg inn på PhotoRobot Account og åpne Developers → Webhooks.
2. Opprett en webhook. Lim inn HTTPS-endepunktet ditt, gi det et internt navn og velg hendelsene du trenger.
3. Kopier signeringshemmeligheten når den vises – den vises bare én gang, helt til du roterer den.
4. Klikk på Send test. Bekreft at webhook.subscription.test kommer frem, og at signaturen verifiseres.
5. Åpne Delivery log for å se nærmere på payload, HTTP-status og nye forsøk.
6. Pek det første abonnementet mot et staging-endepunkt.

‍

‍

Du finner mer teknisk informasjon, blant annet om utviklerkontrakten og signatureksempler, i PhotoRobot Developer Portal – Webhooks.

‍

‍