Novost: Customer Webhooks za PhotoRobot Cloud
PhotoRobot predstavlja Customer Webhooks za PhotoRobot Cloud, s katerimi s podpisanimi odhodnimi webhooki povežete svoj sistem DAM, PIM, ERP ali lastno avtomatizacijo.
Customer Webhooks za PhotoRobot Cloud
Vaši razvijalci in IT-ekipe lahko zdaj s podpisanimi odhodnimi webhooki povežejo PhotoRobot Cloud s sistemom DAM, PIM, ERP ali z lastno avtomatizacijo. Customer webhooks v PhotoRobot Cloud omogočajo zanesljivo dostavo podatkov, ki jo sprožijo dogodki – in s tem popolno povezljivost med vašim studiem in sistemi.
Zaprite zanko med studiem in sistemi
Poskrbite, da vaši podrejeni sistemi izvedo, kdaj se spremeni status elementa ali nastopi dogodek razpoložljivosti gostovanja. PhotoRobot Cloud Customer Webhooks dostavijo vsak dogodek na vaše končne točke, tako da integracije ostanejo vodene z dogodki in ne temeljijo na poizvedovanju (polling).
Trenutno podprti dogodki so:
- item.status.changed – potrjena sprememba statusa zajema pri enem elementu.
- item.status.bulk_changed — en dogodek po skupinski spremembi statusa v Cloudu.
- hosting.item.availability.changed — gostovana vsebina je postala na voljo za prenos ali pa ni več na voljo.
- webhook.subscription.test — samo pošiljanje testa.
Zanesljiva dostava podatkov, vodena z dogodki
Customer Webhooks v PhotoRobot Cloud vključujejo funkcije za:
- Odhodne naročnine na webhooke, ki jih upravljate skupaj z razvojnimi integracijami.
- Podpisano dostavo HTTP, da lahko prejemniki preverijo pristnost.
- „Send test“ in filtre za potrditev naročnine na webhook in preverjanja podpisa.
- Dnevnik dostave za pregled podatkov (payload), statusa HTTP in ponovnih poskusov.
- Razvijalski vmesnik pod Webhooks — webhooki in dostave so ob ključih API.
Jezik, ki ga razumejo produkcijske integracije
Customer Webhooks so manjkajoči člen med robotiziranim zajemom in podjetniškimi evidenčnimi sistemi. Webhook je podpisan signal, ki namenoma nosi le majhne podatkovne pakete. Po odgovoru 2xx integracija prenese trenutni element iz REST v2 (pull.itemUrl / pull.deltaUrl). Webhooki lahko obvestijo založnika ali pa – po prenosu – vaši ekipi pomagajo sprožiti čiščenje predpomnilnika CDN ali posodobiti oglas na tržnici. PhotoRobot Cloud zdaj govori jezik vaših produkcijskih integracij.
Najprej signal, nato prenos
Podatkovni paketi so namenoma majhni. Vsak paket navaja dogodek, organizacijo in (kadar je relevanten) element ter pull.itemUrl in pull.deltaUrl. Paketi ne vsebujejo slikovnih binarnih datotek, celotnih dreves map ali popolnega zapisa izdelka.
Razvijalci naj implementirajo naslednji vzorec:
- Prejmite zahtevo POST in preverite X-PhotoRobot-Signature glede na neobdelano telo zahteve.
- Hitro vrnite 2xx — uvoz v DAM ali posodobitev tržnice izvedite v lastnem delavcu (worker).
- Odstranite dvojnike glede na ID dogodka. Dostava poteka najmanj enkrat (at-least-once).
- S pomočjo URL-jev za prenos pridobite trenutno stanje iz gostovanja REST v2.
Ravno ta ločitev omogoča zanesljivo integracijo. PhotoRobot ne čaka, da se zaključi vaše opravilo kataloga, vaš sistem pa obvestila nikoli ne obravnava kot katalog.
Pogosti primeri uporabe Customer Webhooks
Med najpogostejše primere uporabe Customer Webhooks v ekosistemu PhotoRobot sodijo:
- Osvežitev sistema PIM ali DAM. Naročite se na hosting.item.availability.changed. Ko so gostovani mediji na voljo za prenos, pridobite itemUrl in posodobite izdelek – vrtljive prikaze, fotografije in metapodatke naenkrat.
- Objava na tržnici. Filtrirajte dogodke gostovanja na „Became downloadable“. Ponudbo objavite ali posodobite šele, ko lahko PhotoRobot slike dejansko posreduje.
- Pregled proizvodne plošče. Naročite se na item.status.changed, kadar vaš sistem ERP ali plošča za nadzor kakovosti potrebuje informacijo, da je bil element premaknjen v stanje EDITED, APPROVED ali PUBLISHED – še preden je gostovanje pripravljeno.
- Množične posodobitve kampanj. Po večji spremembi statusa v storitvi Cloud prispe en dogodek item.status.bulk_changed z naslovom deltaUrl. Obdelajte prizadeti nabor elementov, namesto da pričakujete na tisoče webhookov za posamezne elemente.
- Razveljavitev predpomnilnika ali omrežja CDN. Ko gostovanje preklopi v stanje na voljo ali ni na voljo, počistite ali predhodno napolnite poti, ki jih vaša spletna trgovina že pozna. Webhook je sprožilec, vir novih naslovov URL pa je Hosting API.
Kako nastavite Customer Webhooks
Če želite nastaviti Customer Webhooks za PhotoRobot Cloud, odprite svoj PhotoRobot Account v načinu Developers in z možnostjo Webhooks ustvarite naročnino na webhook. Nato naročnino usmerite na preskusno (staging) končno točko, da preverite prvo dostavo.
- Prijavite se v PhotoRobot Account in odprite Developers → Webhooks.
- Ustvarite webhook. Prilepite svojo končno točko HTTPS, določite interno ime in izberite dogodke, ki jih potrebujete.
- Ko se prikaže, kopirajte skrivnost za podpisovanje – prikazana je enkrat, dokler je ne zamenjate.
- Kliknite Send test. Preverite, ali je prispel dogodek webhook.subscription.test in ali se podpis uspešno preveri.
- Odprite Delivery log in preglejte vsebino sporočila, status HTTP in ponovne poskuse.
- Prvo naročnino usmerite na preskusno (staging) končno točko.
Za več tehničnih informacij, vključno s pogodbo za razvijalce in primeri podpisov, glejte PhotoRobot Developer Portal – Webhooks.
