Bevezetés: Ügyfél webhookok a PhotoRobot Cloud számára

Ügyfél webhookok a PhotoRobot Cloudhoz

Fejlesztőid és IT csapatai mostantól csatlakoztathatják a PhotoRobot Cloudot a DAM, PIM, ERP vagy egyedi automatizációhoz aláírt kimenő webhookokkal. Az ügyfél webhookjai a PhotoRobot Cloudban megbízható, eseményvezérelt adatátvitelt kínálnak – biztosítva a teljes kapcsolatot stúdiód és a rendszerek között.

‍

‍

‍

Zárd le a kört a stúdiód és a rendszerek között

Biztosítsd a lefelé vezető rendszereidet is, hogy tudják, ha egy termék státusza megváltozik vagy egy hosting elérhetőségi esemény történik. A PhotoRobot Cloud ügyfél webhookjai minden eseményt a végpontokhoz szállítanak, így az integrációk eseményvezérelt maradnak – nem szavazás-alapúak.

Az élő események a következők:

• item.status.changed – egy tárgyon elkötelezett capture-status változás.
• item.status.bulk_changed — egy esemény egy felhő tömeges státuszváltozása után.
• hosting.item.availability.changed — a hódolt média letölthető vagy elérhetetlenné vált.
• webhook.subscription.test — Csak teszt küldése.

‍

‍

‍

Megbízható, eseményvezérelt adatadás

Az ügyfél webhookjai a PhotoRobot Cloudban tartalmaznak olyan funkciókat:

• A kimenő webhook előfizetések a fejlesztői integrációkkal együtt kezelhetők.
• Aláírt HTTP kézbesítés , hogy a címebek ellenőrizhessék az autentiust is.
• "Send teszt" és szűrők a webhook előfizetés és aláírás ellenőrzésének megerősítéséhez.
• Szállítási napló a hasznos rakomány, HTTP státusz és az újrakeresések ellenőrzéséhez.
• Fejlesztői felület a Webhooks alatt — a webhookok és a szállítások az API kulcsok mellett működnek.

‍

‍

‍

Beszélni a nyelvedet a termelési integrációkhoz

Az ügyfél webhookok a robotizált rögzítés és a vállalati nyilvántartási rendszerek hiányzó láncszeme. A webhook egy jeljel, amely szándékosan csak kis hasznos terheket szállít. 2xx után az integráció lehúzza a jelenlegi elemet a REST v2-ből (pull.itemUrl / pull.deltaUrl). A webhookok értesíthetik a kiadót, vagy a lekérdezés után segíthetnek a csapatodnak a CDN törlés elindításában vagy egy piaci lista frissítésében. A PhotoRobot Cloud most már a te nyelvedet használja a termelési integrációkhoz.

‍

‍

‍

Egy jel, aztán egy húzás

A hasznos terhek szándékosan kicsik maradnak. Minden hasznos rada megnevezi az eseményt, a szervezetet, és (ha releváns) az elemet, plusz a pull.itemUrl-t és a pull.deltaUrl-t. A hasznos terhek nem hordoznak kép-binárisokat, teljes mappáfákat vagy teljes termékrekordot.

A mintafejlesztőknek a megvalósítása a következő:

1. Fogadd meg a POST-ot, és ellenőrizd az X-PhotoRobot-Signature-t a nyers testhez.
2. Gyorsan térj vissza 2xx — végezd el a DAM importot vagy a piacteret a saját dolgozódban.
3. Deduplikálás eseményazonosító szerint. A kézbesítés legalább egyszer történik.
4. A jelenlegi állapotot a REST v2 hostból a pull URL-ekkel szerezzük.

Ez a megosztás teszi megbízhatóvá az integrációt. A PhotoRobot nem várja meg, amíg a katalógus munka befejeződik, és a rendszered soha nem kezeli az értesítést a katalógusként.

‍

‍

‍

Gyakori példák az ügyfél webhook-okra

A PhotoRobot ökoszisztémában az ügyfél webhook-ok leggyakoribb felhasználási esetei a következők:

• PIM vagy DAM frissítés. Iratkozz fel a hosting.item.availability.changed oldalra. Amikor a hásztetett média letölthetővé válik, húzd le az itemUrl-t, és frissítse a terméket — pörgetések, állóképek és metaadatok egy körzetben.
• Piacteri listázás. Szűrd a rendezvényeket "Letölthetővé" opcióra. Tüntesd közzé vagy frissítsd a listát csak azután, hogy a PhotoRobot ténylegesen képes megjeleníteni a képeket.
• Produkciós panel láthatósága. Iratkozz fel az item.status.changed-re, amikor az ERP vagy QC igazgatóságnak tudnia kell, hogy egy tétel átkerült SZERKESZTETT, JÓVÁHAGYOTT vagy KÖZZÉTETT állapotba — még mielőtt a háring készen állna.
• Tömeges kampányfrissítések. Egy nagy státuszváltás után a felhőben egy item.status.bulk_changed esemény érkezik egy deltaUrl-lel. Nézd be az érintett készletet, ahelyett, hogy több ezer webhook-ra számítnál egy tételenként.
• Cache vagy CDN érvénytelenítés. Amikor a hárda elérhető vagy nem elérhető állapotba vált, töröld vagy melegítse azokat az útvonalakat, amelyeket a bolt már ismer. A webhook a kiváltó tényező; A hosting API az új URL-ek forrása.

‍

‍

‍

Hogyan konfigurálhatod az ügyfél webhookjait

Az PhotoRobot Cloud ügyfél-webhookjai beállításához nyisd meg a PhotoRobot fiókodat Fejlesztő módban, és használd a Webhooks-t webhook-előfizetés létrehozására. Ezután irányítsd az előfizetést a staging végpontodhoz, hogy ellenőrizd az első kézbesítést.

‍

‍

1. Jelentkezz be PhotoRobot fiókba, és nyisd meg a Developers → Webhooks menüpontot.
2. Hozz létre egy webhookot. Ragadd be a HTTPS végpontodat, adj neki belső nevet, és válaszd ki a szükséges eseményeket.
3. Másold le az aláírási titkot, amikor megjelenik — egyszer jelenik meg, amíg meg nem forgatod.
4. Kattints a teszt küldésére. Erősítsd meg, hogy webhook.subscription.test megérkezik, és az aláírás igazolódik.
5. Nyisd meg a Delivery naplót a hasznos rakomány, HTTP státusz és a próbálkozások ellenőrzéséhez.
6. Irányítsd az első előfizetést egy staging végpontra.

‍

‍

További technikai információkért, beleértve a fejlesztői szerződés- és aláírási példákat, lásd a PhotoRobot Fejlesztői Portált – Webhooks-ot.

‍

‍