Predstavljamo: Web hookovi za korisnike za PhotoRobot Cloud

Web hookovi za korisnike za PhotoRobot Cloud

Vaši programeri i IT timovi sada mogu povezati PhotoRobot Cloud s vašim DAM, PIM, ERP-om ili prilagođenom automatizacijom putem potpisanih odlaznih webhookova. Korisničke webhookove u PhotoRobot Cloudu nude pouzdanu, događajima vođenu isporuku podataka – osiguravajući potpunu povezanost između vašeg studija i sustava.

‍

‍

‍

Zatvorite petlju između studija i sustava

Pobrinite se da vaši sustavi u nizvodstvu znaju kada se status artikla mijenja ili kada se dogodi događaj dostupnosti hosta. PhotoRobot Cloud Web hookovi za korisnike isporučuju svaki događaj vašim krajnjim uređajima tako da integracije ostanu vođene događajima – a ne temeljene na anketama.

Događaji uživo su:

• Item.Status.Changed – Potvrđena promjena statusa hvatanja na jednom predmetu.
• item.status.bulk_changed — jedan događaj nakon masovne promjene statusa u oblaku.
• Hosting.item.availability.changed — Hostirani mediji postali su dostupni za preuzimanje ili nedostupni.
• webhook.subscription.test — Pošaljite samo test.

‍

‍

‍

Pouzdana, događajima vođena isporuka podataka

Web hookovi za korisnike u PhotoRobot Cloudu uključuju značajke za:

• Odlazne webhook pretplate upravljane zajedno s integracijama za programere.
• Potpisana HTTP isporuka kako bi primatelji mogli provjeriti autentičnost.
• "Pošalji test" i filteri za potvrdu pretplate na webhook i verifikacije potpisa.
• Dnevnik isporuke za pregled korisnog sadržaja, HTTP statusa i ponavljanja.
• Developer UI pod Webhookovima — webhookovi i isporuke su uživo uz API ključeve.

‍

‍

‍

Govor vašeg jezika za produkcijske integracije

Korisnički Webhookovi su nedostajuća karika između robotiziranog snimanja i sustava evidencije tvrtke. Webhook je potpisani signal, koji namjerno nosi samo male terete. Nakon 2xx, integracija povlači trenutni element iz REST v2 (pull.itemUrl / pull.deltaUrl). Webhookovi mogu obavijestiti izdavača ili, nakon povlačenja, omogućiti vašem timu pokretanje CDN čišćenja ili ažuriranje oglasa na tržištu. PhotoRobot Cloud sada govori vašim jezikom za produkcijske integracije.

‍

‍

‍

Signal, pa povlačenje

Korisni tereti namjerno ostaju mali. Svaki teret imenuje događaj, organizaciju i (kada je relevantno) stavku, plus pull.itemUrl i pull.deltaUrl. Korisni tereti ne nose binarne datoteke slika, cijela stabla mapa ili potpuni zapis proizvoda.

Obrazac koji bi programeri trebali implementirati je:

1. Primite POST i provjerite X-PhotoRobot-potpis u odnosu na sirovo tijelo.
2. Brzo vrati 2xx — napravi uvoz DAM-a ili ažuriranje marketplacea u svom workeru.
3. Deduplikirajte prema ID-u događaja. Isporuka je barem jednom.
4. Dohvatite trenutno stanje s REST v2 hostinga koristeći pull URL-ove.

Ta podjela je ono što integraciju čini pouzdanom. PhotoRobot ne čeka da vaš katalog završi, a vaš sustav nikada ne tretira obavijest kao katalog.

‍

‍

‍

Uobičajeni primjeri korištenja korisničkih webhookova

Najčešći slučajevi upotrebe korisničkih Webhookova u PhotoRobot ekosustavu uključuju:

• PIM ili DAM osvježenje. Pretplatite se na hosting.item.availability.changed. Kada hostani mediji postanu dostupni za preuzimanje, povucite itemUrl i ažurirajte proizvod — spinove, fotografije i metapodatke u jednom prolazu.
• Popis na Marketplaceu. Filtrirajte događaje za hosting na "Postali su dostupni za preuzimanje." Objavite ili ažurirajte oglas tek nakon što PhotoRobot zaista može prikazati slike.
• Vidljivost produkcijske ploče. Pretplatite se na item.status.changed kada vaš ERP ili QC odbor trebaju znati da je stavka premještena u UREĐENO, ODOBRENO ili OBJAVLJENO — čak i prije nego što je hosting spreman.
• Masovna ažuriranja kampanja. Nakon velike promjene statusa u Cloudu, jedan item.status.bulk_changed događaj dolazi s deltaUrl-om. Pratite pogođeni skup umjesto da očekujete tisuće webhookova po stavci.
• Poništavanje cachea ili CDN-a. Kada hosting prelazi na dostupno ili nedostupno, očistite ili zagrijte puteve koje vaša trgovina već poznaje. Webhook je okidač; Hosting API je izvor novih URL-ova.

‍

‍

‍

Kako konfigurirati web hookove za korisnike

Za postavljanje korisničkih Webhookova za PhotoRobot Cloud, otvorite svoj PhotoRobot račun u načinu rada za programere i koristite Webhooks za kreiranje webhook pretplate. Zatim usmjerite pretplatu na svoju početnu točku kako biste provjerili prvu dostavu.

‍

‍

1. Prijavite se na PhotoRobot račun i otvorite Developers → Webhooks.
2. Napravite webhook. Zalijepite svoj HTTPS endpoint, dajte mu interno ime i odaberite događaje koji su vam potrebni.
3. Kopirajte tajnu potpisivanja kad se pojavi — prikazuje se jednom dok je ne rotirate.
4. Kliknite Pošalji test. Potvrdi da je webhook.subscription.test stigao i potpis se potvrdio.
5. Otvorite dnevnik isporuke kako biste pregledali korisni sadržaj, HTTP status i ponovna ponavljanja.
6. Prvu pretplatu usmjerite na staging endpoint.

‍

‍

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

‍

‍