Introduksjon: Kunde-webhooks for PhotoRobot Cloud

Kunde-webhooks for PhotoRobot Cloud

Utviklerne og IT-teamene dine kan nå koble PhotoRobot Cloud til din DAM, PIM, ERP eller tilpasset automatisering med signerte utgående webhooks. Kundewebhooks i PhotoRobot Cloud tilbyr pålitelig, hendelsesdrevet datalevering – og sikrer full tilkobling mellom studioet ditt og systemene.

‍

‍

‍

Lukk løkken mellom studioet ditt og systemene dine

Sørg for at nedstrømssystemene dine vet når en varestatus endres eller en hosting-tilgjengelighetshendelse oppstår. PhotoRobot Cloud Customer Webhooks leverer hver hendelse til endepunktene dine slik at integrasjonene forblir hendelsesdrevne – ikke polling-baserte.

Live-arrangementene er:

• Item.status.changed – utført opptaksstatusendring på ett element.
• item.status.bulk_changed — én hendelse etter en masseendring i Cloud status.
• hosting.item.availability.changed — hostet media ble nedlastbart eller utilgjengelig.
• webhook.subscription.test — Send kun test.

‍

‍

‍

Pålitelig, hendelsesdrevet datalevering

Kunde-webhooks i PhotoRobot Cloud inkluderer funksjoner for:

• Utgående webhook-abonnementer håndteres sammen med utviklerintegrasjonene dine.
• Signert HTTP-levering slik at mottakere kan verifisere ekthet.
• "Send test" og filtre for å bekrefte webhook-abonnement og signaturverifisering.
• Leveringslogg for å inspisere nyttelasten, HTTP-status og forsøk.
• Utviklergrensesnitt under Webhooks — webhooks og leveranser ligger ved siden av API-nøkler.

‍

‍

‍

Snakker språket ditt for produksjonsintegrasjoner

Kunde-Webhooks er det manglende leddet mellom robotisert opptak og selskapets registreringssystemer. Webhooken er et signert signal som med vilje bare bærer små laster. Etter 2xx henter integrasjonen det nåværende elementet fra REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks kan varsle en utgiver, eller etter hentingen, hjelpe teamet ditt med å starte en CDN-rensing eller oppdatere en markedsplassoppføring. PhotoRobot Cloud snakker nå ditt språk for produksjonsintegrasjoner.

‍

‍

‍

Et signal, så et trekk

Nyttelastene forblir små med vilje. Hver nyttelast navngir hendelsen, organisasjonen og (når relevant) elementet, pluss pull.itemUrl og pull.deltaUrl. Nyttelaster bærer ikke bildebinærer, fullstendige mappetrær eller en komplett produktpost.

Mønsterutviklerne bør implementere er:

1. Motta POST og verifiser X-PhotoRobot-Signature mot råkroppen.
2. Returner 2xx raskt — gjør DAM-importen eller markedsplassoppdateringen i din egen arbeider.
3. Dedupliser etter hendelses-ID. Levering skjer minst én gang.
4. Hente nåværende tilstand fra REST v2-hosting ved å bruke pull URL-ene.

Den delingen er det som gjør integrasjonen pålitelig. PhotoRobot venter ikke på at katalogjobben din skal bli ferdig, og systemet ditt behandler aldri en varsling som katalogen.

‍

‍

‍

Vanlige eksempler på kunde-webhooks i bruk

De vanligste bruksområdene for Customer Webhooks i PhotoRobot-økosystemet inkluderer:

• PIM- eller DAM-oppdatering. Abonner på hosting.item.availability.changed. Når hostet media blir nedlastbart, hent itemUrl og oppdater produktet — spinn, stillbilder og metadata i ett pass.
• Markedsplassoppføring. Filtrer vertsarrangementer til «Ble nedlastbar.» Publiser eller oppdater oppføringen først etter at PhotoRobot faktisk kan vise bildene.
• Synlighet på produksjonsbrettet. Abonner på item.status.changed når ERP- eller QC-kortet ditt trenger å vite at et element er flyttet til REDIGERT, GODKJENT eller PUBLISERT — selv før hosting er klart.
• Bulk-kampanjeoppdateringer. Etter en stor statusendring i skyen kommer én item.status.bulk_changed hendelse med en deltaUrl. Ta igjen det berørte sett i stedet for å forvente tusenvis av webhooks per element.
• Cache- eller CDN-ugyldiggjøring. Når hosting bytter til tilgjengelig eller utilgjengelig, fjern eller varm opp stiene butikken din allerede kjenner. Webhooken er triggeren; Hosting API er kilden til de nye URL-ene.

‍

‍

‍

Hvordan konfigurere dine kunde-webhooks

For å sette opp Customer Webhooks for PhotoRobot Cloud, åpne PhotoRobot-kontoen din i utviklermodus og bruk Webhooks for å opprette et webhook-abonnement. Deretter peker du abonnementet mot staging-endepunktet for å verifisere den første leveransen.

‍

‍

1. Logg inn på kontoen PhotoRobot og åpne Utviklere → Webhooks.
2. Lag en webhook. Lim inn HTTPS-endepunktet ditt, gi det et internt navn, og velg de hendelsene du trenger.
3. Kopier signeringshemmeligheten når den dukker opp — den vises én gang til du roterer den.
4. Klikk på Send test. Bekreft at webhook.subscription.test ankommer og signaturen bekreftes.
5. Åpne leveringslogg for å inspisere nyttelasten, HTTP-status og forsøk på nytt.
6. Pek det første abonnementet mot et staging-endepunkt.

‍

‍

For mer teknisk informasjon, inkludert eksempler på utviklerkontrakter og signaturer, se PhotoRobot Developer Portal – Webhooks.

‍

‍