Představujeme: Zákaznické webhooky pro PhotoRobot Cloud

Zákaznické webhooky pro PhotoRobot Cloud

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

‍

‍

‍

Uzavřete smyčku mezi studiem a systémy

Zajistěte, aby vaše downstream systémy věděly, kdy se změní stav položky nebo nastane událost dostupnosti hostingu. PhotoRobot Cloud Customer Webhooks doručují každou událost na vaše koncové body, takže integrace zůstávají řízené událostmi – nikoli založené na anketách.

Živé akce jsou:

• Item.Status.Changed – Změněná verze zachycení u jedné položky.
• item.status.bulk_changed — jedna událost po změně stavu cloudu hromadně.
• host.item.availability.changed — hostovaná média se stala stahovatelnými nebo nedostupnými.
• webhook.subscription.test — Pouze posílat test.

‍

‍

‍

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

Zákaznické webhooky v PhotoRobot Cloud obsahují funkce pro:

• Odchozí odběry webhooků spravované spolu s integracemi pro vývojáře.
• Podepsané HTTP doručení , aby příjemci mohli ověřit pravost.
• "Odeslat test" a filtry pro potvrzení odběru webhooku a ověření podpisu.
• Delivery log pro kontrolu payloadu, stavu HTTP a opakovaných záznamů.
• Uživatelské rozhraní pro vývojáře pod Webhooky — webhooky a doručení jsou živé vedle API klíčů.

‍

‍

‍

Mluvení vaším jazykem pro produkční integrace

Zákaznické Webhooky jsou chybějícím článkem mezi robotizovaným zachycováním a firemními systémy záznamu. Webhook je podepsaný signál, který záměrně přenáší jen malé náklady. Po 2xx integrace stáhne aktuální položku z REST v2 (pull.itemUrl / pull.deltaUrl). Webhooky mohou upozornit vydavatele nebo po stažení usnadnit vašemu týmu zahájení čištění CDN či aktualizaci nabídky na tržišti. PhotoRobot Cloud nyní mluví vaším jazykem pro produkční integrace.

‍

‍

‍

Signál, pak tah

Užitečné zatížení zůstávají záměrně malé. Každý payload jmenuje událost, organizaci a (pokud je to relevantní) položku, plus pull.itemUrl a pull.deltaUrl. Payloady neobsahují binární soubory obrázků, kompletní stromy složek ani kompletní produktový záznam.

Vzor, který by měli vývojáři implementovat, je:

1. Přijměte POST a ověřte X-PhotoRobot-Signature proti surovému tělu.
2. Rychle vraťte 2xx — proveďte import DAM nebo aktualizaci marketplace ve svém vlastním workeru.
3. Deduplikujte podle ID události. Doručení je minimálně jednou.
4. Načítej aktuální stav z REST v2 hostingu pomocí pull URL.

Právě toto rozdělení dělá integraci spolehlivou. PhotoRobot nečeká, až dokončíte práci s katalogem, a váš systém nikdy nepovažuje oznámení za katalog.

‍

‍

‍

Běžné příklady používání webhooků pro zákazníky

Nejčastější případy použití Customer Webhooků v ekosystému PhotoRobot zahrnují:

• PIM nebo DAM obnovit. Přihlaste se k odběru hosting.item.availability.changed. Když se hostované médium stane stahovatelným, stahujte si itemUrl a aktualizujte produkt — spiny, statické obrázky a metadata najednou.
• Záznam na tržišti. Filtrujte hostování akcí na "Stalo se stahovatelným". Zveřejněte nebo aktualizujte záznam až poté, co PhotoRobot skutečně zobrazí obrázky.
• Viditelnost produkční desky. Přihlaste se k odběru item.status.changed, když vaše ERP nebo QC rada potřebuje vědět, že položka byla přesunuta do EDITED, APAPPROVED nebo PUBLISHED — ještě předtím, než je hosting připraven.
• Hromadné aktualizace kampaní. Po velké změně stavu v Cloudu dorazí jedna item.status.bulk_changed událost s deltaUrl. Dohoďte postiženou sadu místo toho, abyste očekávali tisíce webhooků na položku.
• Cache nebo CDN neplatnost. Když se hosting změní na dostupné nebo nedostupné, vyčistěte nebo zahřte cesty, které váš obchod již zná. Webhook je spouštěč; Hosting API je zdrojem nových URL.

‍

‍

‍

Jak nastavit své zákaznické webhooky

Pro nastavení Customer Webhooks pro PhotoRobot Cloud otevřete svůj účet PhotoRobot v režimu Developers a použijte Webhooks k vytvoření odběru webhooku. Poté nasměrujte předplatné na svůj staging endpoint pro ověření první doručení.

‍

‍

1. Přihlaste se do PhotoRobot účtu a otevřete Developers → Webhooks.
2. Vytvořte webhook. Vložte svůj HTTPS endpoint, dejte mu interní název a vyberte potřebné události.
3. Zkopírujte podpisové tajemství, když se objeví — zobrazí se jednou, dokud ho neotočíte.
4. Klikněte na Odeslat test. Potvrďte, že webhook.subscription.test dorazil a podpis se ověřil.
5. Otevřete log doručení , abyste zkontrolovali payload, stav HTTP a opakované záznamy.
6. První předplatné nasměrujte na staging endpoint.

‍

‍

Pro více technických informací, včetně příkladů smluv pro vývojáře a podpisů, navštivte PhotoRobot Developer Portal – Webhooks.

‍

‍