Újdonság: Customer Webhooks a PhotoRobot Cloud számára
A PhotoRobot bemutatja a PhotoRobot Cloud Customer Webhooks funkcióját, amellyel aláírt kimenő webhookok segítségével kötheti össze DAM-, PIM- vagy ERP-rendszerét, illetve egyedi automatizálását.
Customer Webhooks a PhotoRobot Cloud számára
Fejlesztői és IT-csapatai mostantól aláírt kimenő webhookok segítségével összekapcsolhatják a PhotoRobot Cloud rendszert DAM-, PIM- vagy ERP-rendszerükkel, illetve egyedi automatizálásukkal. A PhotoRobot Cloud ügyfél-webhookjai megbízható, eseményvezérelt adatátvitelt kínálnak, így teljes körű kapcsolatot biztosítanak a stúdió és a rendszerei között.
Zárja be a kört a stúdió és a rendszerei között
Gondoskodjon róla, hogy a downstream rendszerek értesüljenek az elemek állapotváltozásáról vagy a hosztolt elérhetőség változásáról. A PhotoRobot Cloud Customer Webhooks minden eseményt a megadott végpontokra kézbesít, így az integrációk eseményvezéreltek maradnak, nem lekérdezésalapúak.
Az elérhető események:
- item.status.changed – egyetlen elem rögzített felvételi állapotának véglegesített változása.
- item.status.bulk_changed – egyetlen esemény a Cloudban végrehajtott tömeges állapotváltozás után.
- hosting.item.availability.changed – a hosztolt médiafájl letölthetővé vagy elérhetetlenné vált.
- webhook.subscription.test – kizárólag tesztküldéshez.
Megbízható, eseményvezérelt adatátvitel
A PhotoRobot Cloud Customer Webhooks a következő funkciókat tartalmazza:
- Kimenő webhook-feliratkozások, amelyeket a fejlesztői integrációk mellett kezelhet.
- Aláírt HTTP-kézbesítés, hogy a fogadók ellenőrizhessék a hitelességet.
- „Send test” és szűrők a webhook-feliratkozás és az aláírás-ellenőrzés megerősítéséhez.
- Kézbesítési napló a payload, a HTTP-állapot és az újrapróbálkozások vizsgálatához.
- Fejlesztői felület a Webhooks menüpont alatt – a webhookok és a kézbesítések az API-kulcsok mellett találhatók.
Az Ön nyelvén szólunk – éles integrációkhoz
A Customer Webhooks a hiányzó láncszem a robotizált fotózás és a vállalati nyilvántartó rendszerek között. A webhook egy aláírt jelzés, amely szándékosan csak kis méretű payloadot hordoz. A 2xx válasz után az integráció lekéri az aktuális elemet a REST v2 felületről (pull.itemUrl / pull.deltaUrl). A webhookok értesíthetnek egy publikálót, vagy a lekérés után segíthetnek csapatának a CDN gyorsítótárának ürítésében vagy egy marketplace-hirdetés frissítésében. A PhotoRobot Cloud mostantól az Ön nyelvén beszél az éles integrációk terén.
Először jelzés, aztán lekérés
A payloadok szándékosan kicsik maradnak. Minden payload megnevezi az eseményt, a szervezetet és (ha releváns) az elemet, valamint a pull.itemUrl és a pull.deltaUrl értéket. A payloadok nem tartalmaznak képi binárisokat, teljes mappaszerkezetet vagy teljes termékrekordot.
A fejlesztőknek a következő mintát érdemes megvalósítaniuk:
- Fogadja a POST kérést, és ellenőrizze az X-PhotoRobot-Signature értéket a nyers törzs alapján.
- Gyorsan adjon vissza 2xx választ – a DAM-importot vagy a marketplace-frissítést a saját workerében végezze.
- Szűrje ki az ismétlődéseket az esemény azonosítója alapján. A kézbesítés legalább egyszeri (at-least-once).
- Kérje le az aktuális állapotot a REST v2 hostingból a pull URL-ek segítségével.
Ez a szétválasztás teszi megbízhatóvá az integrációt. A PhotoRobot nem várja meg, amíg az Ön katalógusfeladata befejeződik, az Ön rendszere pedig sosem tekinti az értesítést magának a katalógusnak.
A Customer Webhooks gyakori felhasználási példái
A Customer Webhooks leggyakoribb felhasználási esetei a PhotoRobot ökoszisztémában:
- PIM- vagy DAM-frissítés. Iratkozzon fel a hosting.item.availability.changed eseményre. Amint a tárolt média letölthetővé válik, kérje le az itemUrl értékét, és frissítse a terméket – a körbeforgatható nézeteket, az állóképeket és a metaadatokat egyetlen lépésben.
- Marketplace-listázás. Szűrje a hosting eseményeket a „Became downloadable” eseményre. A listát csak azután tegye közzé vagy frissítse, hogy a PhotoRobot ténylegesen ki tudja szolgálni a képeket.
- Gyártási tábla követése. Iratkozzon fel az item.status.changed eseményre, ha az ERP- vagy QC-táblának tudnia kell, hogy egy elem állapota EDITED, APPROVED vagy PUBLISHED lett – még a hosting elkészülte előtt is.
- Tömeges kampányfrissítések. Ha a Cloudban nagyszabású állapotváltozás történik, egyetlen item.status.bulk_changed esemény érkezik egy deltaUrl címmel. Az érintett elemeket így egyben szinkronizálhatja, ahelyett, hogy elemenként több ezer webhookra várna.
- Gyorsítótár vagy CDN érvénytelenítése. Amikor a hosting elérhetőre vagy nem elérhetőre vált, ürítse vagy melegítse elő azokat az útvonalakat, amelyeket a webáruháza már ismer. A webhook csupán az indító esemény; az új URL-ek forrása a Hosting API.
A Customer Webhooks beállítása
A PhotoRobot Cloud Customer Webhooks funkciójának beállításához nyissa meg a PhotoRobot Account felületet Developers módban, és a Webhooks menüpontban hozzon létre egy webhook-feliratkozást. Ezután irányítsa a feliratkozást a tesztkörnyezeti végpontra, hogy ellenőrizze az első kézbesítést.
- Jelentkezzen be a PhotoRobot Account felületére, és nyissa meg a Developers → Webhooks menüpontot.
- Hozzon létre egy webhookot. Illessze be a HTTPS-végpontot, adjon neki belső nevet, és válassza ki a szükséges eseményeket.
- Másolja ki az aláírási titkot, amikor megjelenik – egyszer látható, a következő cseréig.
- Kattintson a Send test gombra. Ellenőrizze, hogy megérkezik a webhook.subscription.test esemény, és az aláírás érvényes.
- Nyissa meg a Delivery log naplót a payload, a HTTP-állapot és az újrapróbálkozások megtekintéséhez.
- Az első feliratkozást irányítsa tesztkörnyezeti végpontra.
További technikai információkért, többek között a fejlesztői szerződésről és az aláírási példákról, lásd: PhotoRobot Developer Portal – Webhooks.
