Predstavljamo: Customer Webhooks za PhotoRobot Cloud
PhotoRobot predstavlja Customer Webhooks za PhotoRobot Cloud: povežite svoj DAM, PIM, ERP ili prilagođenu automatizaciju pomoću potpisanih odlaznih webhook-ova.
Customer Webhooks za PhotoRobot Cloud
Vaši programeri i IT timovi sada mogu da povežu PhotoRobot Cloud sa Vašim DAM, PIM, ERP sistemom ili prilagođenom automatizacijom pomoću potpisanih odlaznih webhook-ova. Customer webhooks u sistemu PhotoRobot Cloud obezbeđuju pouzdanu isporuku podataka vođenu događajima – za potpunu povezanost između Vašeg studija i Vaših sistema.
Zatvorite krug između Vašeg studija i sistema
Obezbedite da Vaši nizvodni sistemi znaju kada se promeni status stavke ili nastupi događaj dostupnosti hostinga. PhotoRobot Cloud Customer Webhooks isporučuju svaki događaj na Vaše krajnje tačke (endpoints), pa integracije ostaju vođene događajima – a ne zasnovane na upitivanju (polling).
Aktivni događaji su:
- item.status.changed – potvrđena promena statusa snimanja na jednoj stavci.
- item.status.bulk_changed — jedan događaj nakon grupne promene statusa u sistemu Cloud.
- hosting.item.availability.changed — hostovani medij je postao dostupan za preuzimanje ili više nije dostupan.
- webhook.subscription.test — samo slanje testa.
Pouzdana isporuka podataka vođena događajima
Customer Webhooks u sistemu PhotoRobot Cloud obuhvataju funkcije za:
- Pretplate na odlazne webhook-ove kojima se upravlja zajedno sa Vašim integracijama za programere.
- Potpisanu HTTP isporuku kako bi primaoci mogli da provere autentičnost.
- „Send test“ i filtere za potvrdu webhook pretplate i provere potpisa.
- Evidenciju isporuka za uvid u payload, HTTP status i ponovne pokušaje.
- Razvojni korisnički interfejs u odeljku Webhooks — webhook-ovi i isporuke nalaze se pored API ključeva.
Govorimo Vašim jezikom u produkcionim integracijama
Customer Webhooks su karika koja je nedostajala između robotizovanog snimanja i korporativnih evidencionih sistema. Webhook je potpisan signal koji namerno nosi samo male payload-e. Nakon odgovora 2xx, integracija preuzima aktuelnu stavku preko REST v2 (pull.itemUrl / pull.deltaUrl). Webhook-ovi mogu da obaveste izdavača ili, nakon preuzimanja, pomognu Vašem timu da pokrene čišćenje CDN-a (purge) ili ažurira oglasnu ponudu na tržištu (marketplace). PhotoRobot Cloud sada govori Vašim jezikom u produkcionim integracijama.
Signal, pa preuzimanje
Payload-i su namerno mali. Svaki payload navodi događaj, organizaciju i (kada je relevantno) stavku, kao i pull.itemUrl i pull.deltaUrl. Payload-i ne sadrže binarne datoteke slika, kompletna stabla fascikli niti potpun zapis o proizvodu.
Programeri bi trebalo da implementiraju sledeći obrazac:
- Primite POST zahtev i proverite X-PhotoRobot-Signature u odnosu na sirovo telo (raw body) zahteva.
- Brzo vratite odgovor 2xx — DAM uvoz ili ažuriranje na tržištu obavite u sopstvenom worker-u.
- Uklonite duplikate prema ID-u događaja. Isporuka je „najmanje jednom“ (at-least-once).
- Preuzmite aktuelno stanje sa REST v2 hostinga pomoću pull URL adresa.
Upravo ta podela čini integraciju pouzdanom. PhotoRobot ne čeka da se završi Vaš posao u vezi s katalogom, a Vaš sistem nikada ne tretira obaveštenje kao katalog.
Uobičajeni primeri korišćenja Customer Webhooks
Najčešći slučajevi korišćenja Customer Webhooks u PhotoRobot ekosistemu obuhvataju:
- Osvežavanje PIM ili DAM sistema. Pretplatite se na hosting.item.availability.changed. Kada hostovani mediji postanu dostupni za preuzimanje, preuzmite itemUrl i ažurirajte proizvod – spinove, fotografije i metapodatke u jednom prolazu.
- Objava ponude na tržištu (marketplace). Filtrirajte hosting događaje na „Became downloadable“. Objavite ili ažurirajte ponudu tek pošto PhotoRobot zaista može da isporuči slike.
- Pregled statusa u proizvodnji. Pretplatite se na item.status.changed kada Vašem ERP ili QC sistemu treba informacija da je stavka prešla u status EDITED, APPROVED ili PUBLISHED – čak i pre nego što hostovanje bude spremno.
- Masovno ažuriranje kampanja. Nakon velike promene statusa u sistemu Cloud stiže jedan item.status.bulk_changed događaj sa deltaUrl adresom. Uskladite zahvaćeni skup stavki umesto da očekujete hiljade webhook poruka po stavci.
- Poništavanje keša ili CDN-a. Kada hostovanje pređe u stanje dostupno ili nedostupno, obrišite ili unapred učitajte putanje koje Vaša veb-prodavnica već poznaje. Webhook je okidač, a Hosting API je izvor novih URL adresa.
Kako da podesite Customer Webhooks
Da biste podesili Customer Webhooks za PhotoRobot Cloud, otvorite svoj PhotoRobot Account u režimu Developers i pomoću opcije Webhooks napravite webhook pretplatu. Zatim usmerite pretplatu na svoj staging endpoint da biste proverili prvu isporuku.
- Prijavite se u PhotoRobot Account i otvorite Developers → Webhooks.
- Napravite webhook. Nalepite svoj HTTPS endpoint, dajte mu interni naziv i izaberite događaje koji su Vam potrebni.
- Kopirajte tajni ključ za potpisivanje kada se pojavi – prikazuje se samo jednom, sve dok ga ne rotirate.
- Kliknite na Send test. Proverite da li je stigao webhook.subscription.test i da li se potpis uspešno verifikuje.
- Otvorite Delivery log da biste pregledali payload, HTTP status i ponovne pokušaje.
- Prvu pretplatu usmerite na staging endpoint.
Za više tehničkih informacija, uključujući developer contract i primere potpisa, pogledajte PhotoRobot Developer Portal – Webhooks.
