Predstavljamo: Customer Webhooks za PhotoRobot Cloud

Customer Webhooks za PhotoRobot Cloud

Vaši programeri i IT timovi sada mogu povezati PhotoRobot Cloud sa sistemima DAM, PIM, ERP ili vlastitom automatizacijom putem potpisanih odlaznih webhookova. Customer webhooks u PhotoRobot Cloud nude pouzdanu isporuku podataka vođenu događajima – i osiguravaju potpunu povezanost između Vašeg studija i Vaših sistema.

‍

‍

‍

Zatvorite krug između Vašeg studija i sistema

Osigurajte da Vaši nizvodni sistemi znaju kada se promijeni status artikla ili nastupi događaj dostupnosti hostinga. PhotoRobot Cloud Customer Webhooks isporučuju svaki događaj na Vaše endpointe, tako da integracije ostaju vođene događajima – a ne zasnovane na pollingu.

Aktivni događaji su:

• item.status.changed – potvrđena promjena statusa snimanja na jednom artiklu.
• item.status.bulk_changed — jedan događaj nakon skupne promjene statusa u Cloudu.
• hosting.item.availability.changed — hostirani medij postao je dostupan za preuzimanje ili je postao nedostupan.
• webhook.subscription.test — samo slanje testa.

‍

‍

‍

Pouzdana isporuka podataka vođena događajima

Customer Webhooks u PhotoRobot Cloud uključuju funkcije za:

• Odlazne webhook pretplate kojima se upravlja zajedno s Vašim razvojnim integracijama.
• Potpisanu HTTP isporuku kako bi primaoci mogli provjeriti autentičnost.
• „Send test“ i filtere za potvrdu webhook pretplate i provjere potpisa.
• Dnevnik isporuka za uvid u payload, HTTP status i ponovne pokušaje.
• Korisničko sučelje za programere u odjeljku Webhooks — webhookovi i isporuke nalaze se pored API ključeva.

‍

‍

‍

Govorimo Vašim jezikom u produkcijskim integracijama

Customer Webhooks su karika koja je nedostajala između robotiziranog snimanja i poslovnih sistema evidencije. Webhook je potpisani signal koji namjerno nosi samo male payloade. Nakon odgovora 2xx integracija preuzima aktuelni artikal iz REST v2 (pull.itemUrl / pull.deltaUrl). Webhookovi mogu obavijestiti izdavača ili, nakon preuzimanja, pomoći Vašem timu da pokrene CDN purge ili ažurira ponudu na marketplaceu. PhotoRobot Cloud sada govori Vašim jezikom u produkcijskim integracijama.

‍

‍

‍

Signal, pa preuzimanje

Payloadi namjerno ostaju mali. Svaki payload navodi događaj, organizaciju i (kada je relevantno) artikal, te pull.itemUrl i pull.deltaUrl. Payloadi ne sadrže binarne datoteke slika, cjelovita stabla foldera niti kompletan zapis o proizvodu.

Programeri bi trebali implementirati sljedeći obrazac:

1. Primite POST i provjerite X-PhotoRobot-Signature u odnosu na neobrađeno tijelo zahtjeva.
2. Brzo vratite 2xx — DAM import ili ažuriranje marketplacea obavite u vlastitom workeru.
3. Uklonite duplikate prema ID-u događaja. Isporuka je „at-least-once“.
4. Preuzmite aktuelno stanje iz REST v2 hostinga pomoću pull URL-ova.

Upravo ta podjela čini integraciju pouzdanom. PhotoRobot ne čeka da se završi Vaš zadatak ažuriranja kataloga, a Vaš sistem nikada ne tretira obavijest kao sam katalog.

‍

‍

‍

Uobičajeni primjeri korištenja Customer Webhooks

Najčešći slučajevi korištenja Customer Webhooks u PhotoRobot ekosistemu uključuju:

• Osvježavanje PIM-a ili DAM-a. Pretplatite se na hosting.item.availability.changed. Kada hostirani mediji postanu dostupni za preuzimanje, preuzmite itemUrl i ažurirajte proizvod – spinove, fotografije i metapodatke u jednom prolazu.
• Objava na marketplaceu. Filtrirajte hosting događaje na „Became downloadable“. Objavite ili ažurirajte ponudu tek nakon što PhotoRobot zaista može isporučiti slike.
• Pregled stanja u proizvodnji. Pretplatite se na item.status.changed kada Vaš ERP ili QC board treba znati da je artikal prešao u status EDITED, APPROVED ili PUBLISHED – čak i prije nego što hosting bude spreman.
• Skupna ažuriranja kampanja. Nakon velike promjene statusa u servisu Cloud stiže jedan događaj item.status.bulk_changed s deltaUrl adresom. Obradite zahvaćeni skup artikala umjesto da očekujete hiljade webhookova za pojedinačne artikle.
• Poništavanje keša ili CDN-a. Kada hosting pređe u stanje dostupno ili nedostupno, očistite ili zagrijte putanje koje Vaša web trgovina već poznaje. Webhook je okidač, a Hosting API je izvor novih URL-ova.

‍

‍

‍

Kako konfigurirati Customer Webhooks

Za postavljanje Customer Webhooks za PhotoRobot Cloud otvorite PhotoRobot Account u načinu Developers i pomoću opcije Webhooks kreirajte pretplatu na webhook. Zatim usmjerite pretplatu na svoj staging endpoint kako biste provjerili prvu isporuku.

‍

‍

1. Prijavite se u PhotoRobot Account i otvorite Developers → Webhooks.
2. Kreirajte webhook. Zalijepite svoj HTTPS endpoint, dajte mu interni naziv i odaberite događaje koji su Vam potrebni.
3. Kopirajte signing secret kada se pojavi – prikazuje se samo jednom, sve dok ga ne rotirate.
4. Kliknite na Send test. Provjerite da je stigao webhook.subscription.test i da se potpis uspješno verificira.
5. Otvorite Delivery log da biste pregledali payload, HTTP status i ponovne pokušaje.
6. Prvu pretplatu usmjerite na staging endpoint.

‍

‍

Za više tehničkih informacija, uključujući developer contract i primjere potpisa, pogledajte PhotoRobot Developer Portal – Webhooks.

‍

‍