Novinka: Customer Webhooks pro PhotoRobot Cloud

Customer Webhooks pro PhotoRobot Cloud

Vaši vývojáři a IT týmy nyní mohou propojit PhotoRobot Cloud s vaším systémem DAM, PIM, ERP nebo s vlastní automatizací pomocí podepsaných odchozích webhooků. Customer webhooks v PhotoRobot Cloud nabízejí spolehlivé doručování dat řízené událostmi a zajišťují plnou konektivitu mezi vaším studiem a vašimi systémy.

‍

‍

‍

Uzavřete okruh mezi studiem a vašimi systémy

Zajistěte, aby vaše navazující systémy věděly, kdy se změní stav položky nebo nastane událost týkající se dostupnosti hostingu. PhotoRobot Cloud Customer Webhooks doručují každou událost na vaše endpointy, takže integrace zůstávají řízené událostmi a nespoléhají na pollování.

Aktuálně dostupné události:

• item.status.changed – potvrzená změna stavu snímání u jedné položky.
• item.status.bulk_changed — jedna událost po hromadné změně stavu v Cloudu.
• hosting.item.availability.changed — hostovaná média se stala dostupnými ke stažení, nebo naopak nedostupnými.
• webhook.subscription.test — pouze odeslání testu.

‍

‍

‍

Spolehlivé doručování dat řízené událostmi

Customer Webhooks v PhotoRobot Cloud zahrnují funkce pro:

• Odchozí odběry webhooků spravované spolu s vašimi vývojářskými integracemi.
• Podepsané doručování přes HTTP, aby příjemci mohli ověřit autenticitu.
• „Send test“ a filtry pro ověření odběru webhooků a kontrolu podpisu.
• Log doručení pro kontrolu payloadu, stavu HTTP a opakovaných pokusů.
• Vývojářské rozhraní v sekci Webhooks — webhooky a doručení najdete vedle klíčů API.

‍

‍

‍

Mluvíme jazykem produkčních integrací

Customer Webhooks jsou chybějícím článkem mezi robotizovaným snímáním a firemními systémy typu „system of record“. Webhook je podepsaný signál, který záměrně přenáší jen malá data (payload). Po odpovědi 2xx si integrace stáhne aktuální položku z REST v2 (pull.itemUrl / pull.deltaUrl). Webhooky mohou upozornit publikační systém nebo – po stažení dat – pomoci vašemu týmu spustit vymazání cache na CDN či aktualizovat nabídku na marketplace. PhotoRobot Cloud tak pro produkční integrace mluví vaší řečí.

‍

‍

‍

Nejprve signál, poté stažení dat

Payloady zůstávají záměrně malé. Každý payload uvádí událost, organizaci a (je-li relevantní) položku, plus pull.itemUrl a pull.deltaUrl. Payloady neobsahují binární data obrázků, úplné stromy složek ani kompletní záznam o produktu.

Vývojáři by měli implementovat tento postup:

1. Přijměte požadavek POST a ověřte X-PhotoRobot-Signature proti nezpracovanému tělu požadavku.
2. Rychle vraťte odpověď 2xx — import do DAM nebo aktualizaci marketplace proveďte ve vlastním workeru.
3. Deduplikujte podle ID události. Doručení probíhá minimálně jednou (at-least-once).
4. Aktuální stav načtěte z hostingu REST v2 pomocí pull URL.

Právě toto oddělení dělá integraci spolehlivou. PhotoRobot nečeká na dokončení vaší katalogové úlohy a váš systém nikdy nepovažuje oznámení za samotný katalog.

‍

‍

‍

Typické příklady použití Customer Webhooks

Mezi nejčastější případy použití Customer Webhooks v ekosystému PhotoRobot patří:

• Aktualizace PIM nebo DAM. Přihlaste se k odběru události hosting.item.availability.changed. Jakmile bude hostované médium ke stažení, načtěte itemUrl a aktualizujte produkt – otočky, statické snímky i metadata na jeden průchod.
• Nabídky na marketplacech. Vyfiltrujte události hostingu na „Became downloadable“. Nabídku zveřejněte nebo aktualizujte teprve ve chvíli, kdy PhotoRobot může obrázky skutečně poskytnout.
• Přehled o stavu výroby. Odebírejte item.status.changed, když váš systém ERP nebo kontrolní board QC potřebuje vědět, že se položka přesunula do stavu EDITED, APPROVED nebo PUBLISHED – i dříve, než je hosting připraven.
• Hromadné aktualizace kampaní. Po rozsáhlé změně stavu v systému Cloud dorazí jediná událost item.status.bulk_changed s adresou deltaUrl. Dotáhněte dotčenou sadu položek, místo abyste čekali tisíce webhooků pro jednotlivé položky.
• Invalidace cache nebo CDN. Když se hosting přepne na dostupný nebo nedostupný, vymažte nebo předehřejte cesty, které váš e-shop už zná. Webhook je spouštěč; zdrojem nových adres URL je Hosting API.

‍

‍

‍

Jak nakonfigurovat Customer Webhooks

Chcete-li nastavit Customer Webhooks pro PhotoRobot Cloud, otevřete svůj PhotoRobot Account v režimu Developers a pomocí položky Webhooks vytvořte odběr webhooků. Poté nasměrujte odběr na svůj testovací (staging) endpoint a ověřte první doručení.

‍

‍

1. Přihlaste se do PhotoRobot Account a otevřete Developers → Webhooks.
2. Vytvořte webhook. Vložte svůj endpoint HTTPS, zadejte interní název a vyberte události, které potřebujete.
3. Zkopírujte podpisové tajemství, jakmile se zobrazí – zobrazí se jen jednou, dokud ho nevyměníte.
4. Klikněte na Send test. Ověřte, že dorazí webhook.subscription.test a podpis je platný.
5. Otevřete Delivery log a zkontrolujte payload, stavový kód HTTP a opakované pokusy.
6. První odběr nasměrujte na testovací endpoint.

‍

‍

Další technické informace včetně příkladů kontraktu pro vývojáře a podpisů najdete na PhotoRobot Developer Portal – Webhooks.

‍

‍