Introduktion: Kunde-webhooks til PhotoRobot Cloud

Kunde-webhooks til PhotoRobot Cloud

Dine udviklere og IT-teams kan nu forbinde PhotoRobot Cloud til din DAM, PIM, ERP eller specialautomatisering med signerede outbound webhooks. Kundewebhooks i PhotoRobot Cloud tilbyder pålidelig, hændelsesdrevet datalevering – hvilket sikrer fuld forbindelse mellem dit studie og dine systemer.

‍

‍

‍

Luk løkken mellem dit studie og dine systemer

Sørg for, at dine downstream-systemer ved, når en varestatus ændres, eller en hosting-tilgængelighedshændelse opstår. PhotoRobot Cloud Customer Webhooks leverer hver begivenhed til dine endepunkter, så integrationerne forbliver hændelsesdrevne – ikke polling-baserede.

Live-arrangementerne er:

• Item.status.changed – udført ændring af capture-status på én opgave.
• item.status.bulk_changed — én hændelse efter en masseændring i Cloud-status.
• hosting.item.availability.changed — hostet medie blev downloadbart eller utilgængeligt.
• webhook.subscription.test — Send kun test.

‍

‍

‍

Pålidelig, hændelsesdrevet datalevering

Kunde-webhooks i PhotoRobot Cloud inkluderer funktioner for:

• Outbound webhook-abonnementer administreres sammen med dine udviklerintegrationer.
• Signeret HTTP-levering , så modtagere kan verificere ægthed.
• "Send test" og filtre for at bekræfte webhook-abonnement og signaturverifikation.
• Leveringslog for at inspicere nyttelasten, HTTP-status og gentagelser.
• Udviklerbrugerinterface under Webhooks — webhooks og leveringer live ved siden af API-nøgler.

‍

‍

‍

At tale dit sprog til produktionsintegrationer

Kunde-webhooks er det manglende led mellem robotiseret optagelse og virksomhedens registreringssystemer. Webhooken er et signeret signal, der med vilje kun bærer små payloads. Efter 2xx henter integrationen det aktuelle element fra REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks kan underrette en udgiver eller, efter trækningen, hjælpe dit team med at igangsætte en CDN-rensning eller opdatere en markedsplads-liste. PhotoRobot Cloud taler nu dit sprog til produktionsintegrationer.

‍

‍

‍

Et signal, så et træk

Payloads forbliver små med vilje. Hver payload navngiver begivenheden, organisationen og (når relevant) elementet plus pull.itemUrl og pull.deltaUrl. Payloads bærer ikke billedbinærfiler, fulde mappetræer eller en komplet produktpost.

Det mønster, udviklerne bør implementere, er:

1. Modtag POST og verificér X-PhotoRobot-Signature mod den rå krop.
2. Returner 2xx hurtigt — lav DAM-importen eller markedspladsopdateringen i din egen medarbejder.
3. Dedupliker efter event ID. Levering sker mindst én gang.
4. Hent den aktuelle tilstand fra REST v2-hosting ved hjælp af pull URL'erne.

Den opdeling er det, der gør integrationen pålidelig. PhotoRobot venter ikke på, at dit katalogjob er færdigt, og dit system behandler aldrig en notifikation som kataloget.

‍

‍

‍

Almindelige eksempler på kunde-webhooks i brug

De mest almindelige anvendelsestilfælde for Customer Webhooks i PhotoRobot-økosystemet inkluderer:

• PIM- eller DAM-opdatering. Abonner på hosting.item.availability.changed. Når hostet medie bliver downloadbart, hent itemUrl og opdater produktet — spins, stillbilleder og metadata i ét gennemløb.
• Markedsplads-opvisning. Filtrer hostende begivenheder til "Blev downloadbar." Publicér eller opdater først listen, efter at PhotoRobot faktisk kan vise billederne.
• Synlighed på produktionstavlen. Abonner på item.status.changed, når din ERP- eller QC-tavle skal vide, at et element er flyttet til REDIGERET, GODKENDT eller PUBLICERET — selv før hosting er klar.
• Masseopdateringer til kampagner. Efter en stor statusændring i Cloud ankommer en item.status.bulk_changed begivenhed med en deltaUrl. Indhent det berørte sæt i stedet for at forvente tusindvis af webhooks pr. item.
• Cache- eller CDN-ugyldiggørelse. Når hosting skifter til tilgængelig eller utilgængelig, så slet eller varm op de stier, din butik allerede kender. Webhooken er triggeren; Hosting-API'en er kilden til de nye URL'er.

‍

‍

‍

Sådan konfigurerer du dine kunde-webhooks

For at opsætte Customer Webhooks til PhotoRobot Cloud skal du åbne din PhotoRobot-konto i Developers-tilstand og bruge Webhooks til at oprette et webhook-abonnement. Derefter peger du abonnementet mod dit staging-endpoint for at verificere den første levering.

‍

‍

1. Log ind på PhotoRobot konto og åbn Udviklere → Webhooks.
2. Opret en webhook. Indsæt dit HTTPS-endpoint, giv det et internt navn, og vælg de events, du har brug for.
3. Kopier signeringshemmeligheden, når den vises — den vises én gang, indtil du roterer den.
4. Klik på Send test. Bekræft webhook.subscription.test ankommer, og signaturen bekræftes.
5. Åbn leveringslog for at inspicere nyttelasten, HTTP-status og gentagelser.
6. Peg det første abonnement mod et staging-endpoint.

‍

‍

For mere teknisk information, herunder eksempler på udviklerkontrakter og signaturer, se PhotoRobot Developer Portal – Webhooks.

‍

‍