Predstavujeme: Zákaznícke webhooky pre PhotoRobot Cloud

Zákaznícke webhooky pre PhotoRobot Cloud

Vaši vývojári a IT tímy teraz môžu prepojiť PhotoRobot Cloud s vaším DAM, PIM, ERP alebo vlastnou automatizáciou pomocou podpísaných odchádzajúcich webhookov. Zákaznícke webhooky v PhotoRobot Cloud ponúkajú spoľahlivé, na udalosti riadené doručovanie dát – zabezpečujúc plnú prepojenosť medzi vaším štúdiom a systémami.

‍

‍

‍

Uzavrite slučku medzi vaším štúdiom a systémami

Uistite sa, že vaše downstream systémy vedia, keď sa zmení stav položky alebo nastane udalosť dostupnosti hostovania. PhotoRobot Cloud Customer Webhooks doručujú každú udalosť na vaše koncové body, aby integrácie zostali riadené udalosťami – nie založené na anketách.

Živé podujatia sú:

• Item.Status.Changed – Záväzná zmena stavu zachytenia jednej položky.
• item.status.bulk_changed — jedna udalosť po hromadnej zmene stavu v cloude.
• hosting.item.availability.changed — hostované médiá sa stali stiahnuteľnými alebo nedostupnými.
• webhook.subscription.test — Posielať len test.

‍

‍

‍

Spoľahlivé, na udalostiach riadené doručovanie dát

Zákaznícke webhooky v PhotoRobot Cloud obsahujú funkcie pre:

• Odchádzajúce webhook predplatné spravované spolu s vašimi vývojárskymi integráciami.
• Podpísané HTTP doručenie , aby si prijímatelia mohli overiť pravosť.
• "Odoslať test" a filtre na potvrdenie odberu webhooku a overenia podpisu.
• Delivery log na kontrolu payloadu, stavu HTTP a opakovaných pokusov.
• Vývojárske rozhranie pod Webhooks — webhooky a doručenia sú živé vedľa API kľúčov.

‍

‍

‍

Hovorenie vaším jazykom pre produkčné integrácie

Zákaznícke Webhooky sú chýbajúcim článkom medzi robotizovaným zachytávaním a firemnými systémami záznamu. Webhook je podpísaný signál, ktorý zámerne nesie len malé náklady. Po 2xx integrácia stiahne aktuálnu položku z REST v2 (pull.itemUrl / pull.deltaUrl). Webhooky môžu upozorniť vydavateľa alebo po stiahnutí uľahčiť vášmu tímu spustenie CDN čistenia či aktualizáciu záznamu na trhu. PhotoRobot Cloud teraz hovorí vaším jazykom pre produkčné integrácie.

‍

‍

‍

Signál, potom ťah

Užitočné zaťaženia zostávajú zámerne malé. Každý payload pomenuje udalosť, organizáciu a (ak je to relevantné) položku, plus pull.itemUrl a pull.deltaUrl. Payloady nenesú binárne súbory obrázkov, kompletné priečinkové stromy ani kompletný produktový záznam.

Vzor, ktorý by mali vývojári implementovať, je:

1. Prijať POST a overiť X-PhotoRobot-Signature voči surovému telu.
2. Vráťte 2xx rýchlo — urobte import DAM alebo aktualizáciu marketplace vo svojom vlastnom workerovi.
3. Deduplikujte podľa ID udalosti. Doručenie je aspoň raz.
4. Získajte aktuálny stav z REST v2 hostingu pomocou pull URL.

Práve toto rozdelenie robí integráciu spoľahlivou. PhotoRobot nečaká na dokončenie vašej úlohy s katalógom a váš systém nikdy nepovažuje notifikáciu za katalóg.

‍

‍

‍

Bežné príklady používania webhookov pre zákazníkov

Najbežnejšie použitia zákazníckych Webhookov v ekosystéme PhotoRobot zahŕňajú:

• PIM alebo DAM refresh. Prihláste sa na hosting.item.availability.changed. Keď sa hostované médiá stanú sťahovateľnými, vytiahnite itemUrl a aktualizujte produkt — spiny, statické snímky a metadáta v jednom prechode.
• Záznam na trhu. Filtrujte hostiteľské udalosti na "Stali sa stiahnuteľnými." Zverejnite alebo aktualizujte záznam až po tom, čo PhotoRobot skutočne zobrazí obrázky.
• Viditeľnosť produkčnej rady. Prihláste sa na odber item.status.changed, keď vaša ERP alebo QC rada potrebuje vedieť, že položka bola presunutá do EDITED, APAPPROVED alebo PUBLISHED — ešte predtým, než je hosting pripravený.
• Hromadné aktualizácie kampaní. Po veľkej zmene stavu v Cloude príde jedna item.status.bulk_changed udalosť s deltaUrl. Dobehnite postihnutú sadu namiesto očakávania tisícov webhookov na položku.
• Neplatnosť cache alebo CDN. Keď sa hosting prepne na dostupné alebo nedostupné, vyčistite alebo zohriate cesty, ktoré váš obchod už pozná. Webhook je spúšťač; Hosting API je zdrojom nových URL.

‍

‍

‍

Ako nastaviť webhooky pre zákazníkov

Ak chcete nastaviť zákaznícke Webhooky pre PhotoRobot Cloud, otvorte svoj PhotoRobot Account v režime Developers a použite Webhooks na vytvorenie predplatného webhooku. Potom nasmerujte predplatné na svoj staging endpoint, aby ste overili prvú dodávku.

‍

‍

1. Prihláste sa do PhotoRobot účtu a otvorte Developers → Webhooks.
2. Vytvor webhook. Vlož svoj HTTPS endpoint, daj mu interný názov a vyber potrebné udalosti.
3. Skopírujte podpisové tajomstvo, keď sa objaví — zobrazí sa raz, kým ho neotočíte.
4. Kliknite na Odoslať test. Potvrďte, že webhook.subscription.test dorazí a podpis sa overí.
5. Otvorte Delivery log, aby ste skontrolovali payload, stav HTTP a opakovania.
6. Nasmerujte prvé predplatné na stagingový endpoint.

‍

‍

Pre viac technických informácií vrátane príkladov zmluvy s vývojárom a podpisov sa pozrite na PhotoRobot Developer Portal – Webhooks.

‍

‍