Novo: Customer Webhooks za PhotoRobot Cloud

Customer Webhooks za PhotoRobot Cloud

Vaši programeri i IT timovi sada mogu povezati PhotoRobot Cloud sa sustavima DAM, PIM, ERP ili s prilagođenom automatizacijom pomoću potpisanih odlaznih webhookova. Customer webhooks u sustavu PhotoRobot Cloud omogućuju pouzdanu isporuku podataka vođenu događajima – za potpunu povezanost između Vašeg studija i Vaših sustava.

‍

‍

‍

Zatvorite krug između Vašeg studija i sustava

Osigurajte da Vaši nizvodni sustavi znaju kada se promijeni status stavke 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 temeljene na pollingu.

Aktivni događaji su:

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

‍

‍

‍

Pouzdana isporuka podataka vođena događajima

Customer Webhooks u sustavu PhotoRobot Cloud uključuju funkcije za:

• Odlazne webhook pretplate kojima upravljate uz svoje razvojne integracije.
• Potpisanu HTTP isporuku kako bi primatelji mogli provjeriti autentičnost.
• „Send test“ i filtere za potvrdu webhook pretplate i provjere potpisa.
• Zapisnik isporuka za uvid u payload, HTTP status i ponovne pokušaje.
• Razvojno sučelje pod Webhooks — webhookovi i isporuke nalaze se pokraj API ključeva.

‍

‍

‍

Govorimo Vaš jezik za produkcijske integracije

Customer Webhooks su karika koja je nedostajala između robotiziranog snimanja i poslovnih sustava evidencije. Webhook je potpisani signal koji namjerno nosi samo male payloade. Nakon odgovora 2xx integracija preuzima trenutačnu stavku putem REST v2 (pull.itemUrl / pull.deltaUrl). Webhookovi mogu obavijestiti publishera ili, nakon preuzimanja, pomoći Vašem timu da pokrene CDN purge ili ažurira oglas na marketplaceu. PhotoRobot Cloud sada govori Vaš jezik za produkcijske integracije.

‍

‍

‍

Signal, pa preuzimanje

Payloadi namjerno ostaju mali. Svaki payload navodi događaj, organizaciju i (kada je relevantno) stavku, uz pull.itemUrl i pull.deltaUrl. Payloadi ne sadrže binarne datoteke slika, cjelovita stabla mapa ni potpuni zapis o proizvodu.

Obrazac koji bi programeri trebali implementirati je:

1. Primite POST i provjerite X-PhotoRobot-Signature u odnosu na neobrađeno tijelo zahtjeva.
2. Brzo vratite 2xx — uvoz u DAM ili ažuriranje marketplacea obavite u vlastitom workeru.
3. Uklonite duplikate prema ID-u događaja. Isporuka je barem jednom (at-least-once).
4. Dohvatite trenutačno stanje iz REST v2 hostinga pomoću pull URL-ova.

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

‍

‍

‍

Uobičajeni primjeri primjene Customer Webhooks

Najčešći slučajevi uporabe za Customer Webhooks u PhotoRobot ekosustavu uključuju:

• Osvježavanje PIM-a ili DAM-a. Pretplatite se na hosting.item.availability.changed. Kada hostirani medijski sadržaj postane dostupan za preuzimanje, preuzmite itemUrl i ažurirajte proizvod – spinove, statične fotografije i metapodatke u jednom prolazu.
• Objava na tržnicama (marketplace). Filtrirajte hosting događaje na „Became downloadable“. Objavite ili ažurirajte oglas tek kada PhotoRobot doista može isporučiti slike.
• Pregled stanja proizvodnje. Pretplatite se na item.status.changed kada Vaš ERP ili QC board treba znati da je artikl prešao u status EDITED, APPROVED ili PUBLISHED – čak i prije nego što je hosting spreman.
• Skupna ažuriranja kampanja. Nakon velike promjene statusa u sustavu Cloud stiže jedan događaj item.status.bulk_changed s deltaUrl-om. Uskladite zahvaćeni skup artikala umjesto da očekujete tisuće webhookova po artiklu.
• Poništavanje predmemorije ili CDN-a. Kada hosting prijeđe u stanje dostupno ili nedostupno, očistite ili unaprijed zagrijte putanje koje Vaša web-trgovina već poznaje. Webhook je okidač; Hosting API je izvor novih URL-ova.

‍

‍

‍

Kako konfigurirati Customer Webhooks

Za postavljanje Customer Webhooks za PhotoRobot Cloud otvorite svoj PhotoRobot Account u načinu Developers i pomoću opcije Webhooks izradite pretplatu na webhook. Zatim usmjerite pretplatu na svoju testnu (staging) krajnju točku kako biste provjerili prvu isporuku.

‍

‍

1. Prijavite se u PhotoRobot Account i otvorite Developers → Webhooks.
2. Izradite webhook. Zalijepite svoju HTTPS krajnju točku, dodijelite joj interni naziv i odaberite događaje koji su Vam potrebni.
3. Kopirajte tajni ključ za potpisivanje čim se pojavi – prikazuje se samo jednom, sve dok ga ne rotirate.
4. Kliknite Send test. Provjerite stiže li webhook.subscription.test i je li potpis valjan.
5. Otvorite Delivery log kako biste pregledali payload, HTTP status i ponovne pokušaje.
6. Prvu pretplatu usmjerite na staging krajnju točku.

‍

‍

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

‍

‍