Novinka: Customer Webhooks pre PhotoRobot Cloud

Customer Webhooks pre PhotoRobot Cloud

Vaši vývojári a IT tímy môžu odteraz prepojiť PhotoRobot Cloud so systémami DAM, PIM, ERP či s vlastnou automatizáciou pomocou podpísaných odchádzajúcich webhookov. Customer Webhooks v PhotoRobot Cloud zabezpečujú spoľahlivé doručovanie dát riadené udalosťami – a tým plnohodnotné prepojenie medzi Vaším štúdiom a Vašimi systémami.

‍

‍

‍

Uzavrite okruh medzi Vaším štúdiom a systémami

Zabezpečte, aby Vaše nadväzujúce systémy vedeli, kedy sa zmení stav položky alebo nastane udalosť dostupnosti hostovaného obsahu. PhotoRobot Cloud Customer Webhooks doručujú každú udalosť na Vaše koncové body, vďaka čomu zostávajú integrácie riadené udalosťami – nie periodickým dopytovaním (polling).

Aktuálne dostupné udalosti:

• item.status.changed – potvrdená zmena stavu snímania jednej položky.
• item.status.bulk_changed — jedna udalosť po hromadnej zmene stavu v Cloude.
• hosting.item.availability.changed — hostované médium sa stalo dostupným na stiahnutie alebo nedostupným.
• webhook.subscription.test — iba odoslanie testu („Send test“).

‍

‍

‍

Spoľahlivé doručovanie dát riadené udalosťami

Customer Webhooks v PhotoRobot Cloud zahŕňajú funkcie pre:

• Odchádzajúce odbery webhookov spravované spolu s Vašimi vývojárskymi integráciami.
• Podpísané doručovanie cez HTTP, aby príjemcovia mohli overiť pravosť.
• „Send test“ a filtre na potvrdenie odberu webhookov a overenia podpisu.
• Záznam doručení na kontrolu payloadu, stavu HTTP a opakovaných pokusov.
• Vývojárske rozhranie v sekcii Webhooks — webhooky a doručenia nájdete vedľa kľúčov API.

‍

‍

‍

Reč, ktorej rozumejú produkčné integrácie

Customer Webhooks sú chýbajúcim článkom medzi robotizovaným snímaním a firemnými evidenčnými systémami. Webhook je podpísaný signál, ktorý zámerne nesie len malé payloady. Po odpovedi 2xx si integrácia stiahne aktuálnu položku z REST v2 (pull.itemUrl / pull.deltaUrl). Webhooky môžu upozorniť vydavateľa alebo – po stiahnutí dát – pomôcť Vášmu tímu spustiť vyčistenie CDN cache alebo aktualizovať ponuku na marketplace. PhotoRobot Cloud teraz hovorí jazykom Vašich produkčných integrácií.

‍

‍

‍

Najprv signál, potom stiahnutie dát

Payloady zostávajú zámerne malé. Každý payload uvádza udalosť, organizáciu a (ak je to relevantné) položku, ako aj pull.itemUrl a pull.deltaUrl. Payloady neobsahujú binárne dáta obrázkov, úplné stromy priečinkov ani kompletný záznam o produkte.

Vývojári by mali implementovať tento postup:

1. Prijmite požiadavku POST a overte X-PhotoRobot-Signature voči nespracovanému telu požiadavky.
2. Rýchlo vráťte odpoveď 2xx — import do DAM alebo aktualizáciu marketplace vykonajte vo vlastnom workeri.
3. Deduplikujte podľa ID udalosti. Doručenie prebieha spôsobom at-least-once.
4. Aktuálny stav stiahnite z hostingu REST v2 pomocou pull URL.

Práve toto oddelenie robí integráciu spoľahlivou. PhotoRobot nečaká na dokončenie vašej úlohy v katalógu a váš systém nikdy nepovažuje oznámenie za samotný katalóg.

‍

‍

‍

Typické príklady využitia Customer Webhooks

Medzi najčastejšie prípady použitia Customer Webhooks v ekosystéme PhotoRobot patria:

• Aktualizácia PIM alebo DAM. Prihláste sa na odber udalosti hosting.item.availability.changed. Keď sa hostované médiá sprístupnia na stiahnutie, načítajte itemUrl a aktualizujte produkt – rotácie, statické fotografie aj metadáta naraz.
• Zverejnenie na marketplace. Filtrujte udalosti hostingu na „Became downloadable“. Ponuku zverejnite alebo aktualizujte až vtedy, keď PhotoRobot dokáže obrázky skutočne poskytnúť.
• Prehľad o stave výroby. Prihláste sa na odber item.status.changed, keď váš ERP alebo QC panel potrebuje vedieť, že položka prešla do stavu EDITED, APPROVED alebo PUBLISHED – aj skôr, než je hosting pripravený.
• Hromadné aktualizácie kampaní. Po rozsiahlej zmene stavu v službe Cloud príde jedna udalosť item.status.bulk_changed s deltaUrl. Dosynchronizujte dotknutú skupinu položiek namiesto očakávania tisícok webhookov pre jednotlivé položky.
• Invalidácia cache alebo CDN. Keď sa hosting prepne na dostupný alebo nedostupný, vyčistite alebo vopred načítajte cesty, ktoré váš e-shop už pozná. Webhook je spúšťač; zdrojom nových URL adries je Hosting API.

‍

‍

‍

Ako nastaviť Customer Webhooks

Ak chcete nastaviť Customer Webhooks pre PhotoRobot Cloud, otvorte svoj PhotoRobot Account v režime Developers a pomocou sekcie Webhooks vytvorte odber webhooku. Potom nasmerujte odber na svoj testovací (staging) endpoint a overte prvé doručenie.

‍

‍

1. Prihláste sa do PhotoRobot Account a otvorte Developers → Webhooks.
2. Vytvorte webhook. Vložte svoj HTTPS endpoint, zadajte interný názov a vyberte udalosti, ktoré potrebujete.
3. Skopírujte podpisový tajný kľúč, keď sa zobrazí – zobrazí sa iba raz, kým ho nezmeníte (rotácia).
4. Kliknite na Send test. Skontrolujte, či príde webhook.subscription.test a či sa podpis úspešne overí.
5. Otvorte Delivery log a skontrolujte payload, stav HTTP a opakované pokusy.
6. Prvý odber nasmerujte na staging endpoint.

‍

‍

Ďalšie technické informácie vrátane kontraktu pre vývojárov a príkladov podpisov nájdete v PhotoRobot Developer Portal – Webhooks.

‍

‍