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 sa vašim DAM, PIM, ERP ili prilagođenom automatizacijom putem potpisanih odlaznih webhookova. Webhookovi za korisnike u PhotoRobot Cloudu nude pouzdanu, događajima vođenu isporuku podataka – osiguravajući potpunu povezanost između vašeg studija i sistema.

‍

‍

‍

Zatvorite petlju između vašeg studija i sistema

Osigurajte da vaši downstream sistemi znaju kada se status artikla mijenja ili kada se dogodi događaj dostupnosti hosta. PhotoRobot Cloud korisnički Webhookovi isporučuju svaki događaj vašim krajnjim uređajima tako da integracije ostanu vođene događajima – a ne zasnovane 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 — hostovani mediji su postali dostupni za preuzimanje ili nedostupni.
• webhook.subscription.test — Samo pošaljite test.

‍

‍

‍

Pouzdana, događajima vođena isporuka podataka

Web hookovi za korisnike u PhotoRobot Cloud uključuju funkcije za:

• Odlazne webhook pretplate upravljane zajedno sa integracijama za programere.
• Potpisana HTTP isporuka kako bi primaoci mogli provjeriti autentičnost.
• "Pošalji test" i filteri za potvrdu pretplate na webhook i verifikaciju potpisa.
• Dnevnik isporuke za inspekciju korisnog sadržaja, HTTP statusa i ponovnih ponovnih analiza.
• Developer UI pod Webhooks — webhookovi i isporuke su uživo pored API ključeva.

‍

‍

‍

Govor vašeg jezika za produkcijske integracije

Web hookovi za kupce su nedostajuća karika između robotiziranog hvatanja i sistema evidencije kompanije. Webhook je potpisani signal, koji namjerno nosi samo male terete. Nakon 2xx, integracija povlači trenutni predmet iz REST v2 (pull.itemUrl / pull.deltaUrl). Webhookovi mogu obavijestiti izdavača ili, nakon povlačenja, olakšati vašem timu pokretanje CDN čišćenja ili ažuriranje liste 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 fajlove slika, kompletna stabla foldera ili kompletan zapis proizvoda.

Obrazac koji programeri trebaju implementirati je:

1. Primite POST i provjerite X-PhotoRobot-potpis u odnosu na sirovo tijelo.
2. Vrati 2xx brzo — uradi DAM import ili ažuriranje marketplace-a u svom workeru.
3. Deduplikuj po ID-u događaja. Isporuka je barem jednom.
4. Preuzmite trenutno stanje sa 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š sistem nikada ne tretira obavijest kao katalog.

‍

‍

‍

Uobičajeni primjeri korisničkih webhookova u upotrebi

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

• PIM ili DAM refresh. Pretplatite se na hosting.item.availability.changed. Kada hostovani mediji postanu dostupni za preuzimanje, povucite itemUrl i ažurirajte proizvod — spinove, statične slike i metapodatke u jednom prolazu.
• Oglas na marketplaceu. Filtrirajte događaje za domaćinstvo na "Postali su dostupni za preuzimanje." Objavite ili ažurirajte oglas tek nakon što PhotoRobot zaista može prikazati slike.
• Vidljivost produkcijske table. Pretplatite se na item.status.changed kada vaš ERP ili QC odbor treba 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 sa deltaUrl-om. Pratite pogođeni skup umjesto da očekujete hiljade webhookova po stavci.
• Cache ili CDN poništavanje. Kada hosting pređe na dostupno ili nedostupno, očistite ili zagrijte puteve koje vaša prodavnica već poznaje. Webhook je okidač; Hosting API je izvor novih URL-ova.

‍

‍

‍

Kako konfigurirati webhookove za korisnike

Da biste postavili korisničke Webhookove za PhotoRobot Cloud, otvorite svoj PhotoRobot nalog u Developers modu i koristite Webhooks za kreiranje webhook pretplate. Zatim usmjerite pretplatu na vašu staging tačku da potvrdite prvu isporuku.

‍

‍

1. Prijavite se na PhotoRobot nalog 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 kada se pojavi — prikazuje se jednom dok je ne rotirate.
4. Kliknite Pošalji test. Potvrdi da webhook.subscription.test stiže i potpis se potvrđuje.
5. Otvorite dnevnik isporuke da pregledate korisni sadržaj, HTTP status i ponovna ispitivanja.
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.

‍

‍