Pristatome: „Customer Webhooks“ skirti PhotoRobot Cloud

„Customer Webhooks“ skirti PhotoRobot Cloud

Jūsų kūrėjai ir IT komandos dabar gali sujungti PhotoRobot Cloud su jūsų DAM, PIM, ERP ar individualia automatizacija naudodami pasirašytus siunčiamuosius webhook’us. „Customer Webhooks“ PhotoRobot Cloud užtikrina patikimą, įvykiais grindžiamą duomenų pristatymą – taip jūsų studija ir sistemos būna visiškai sujungtos.

‍

‍

‍

Užverkite ciklą tarp savo studijos ir sistemų

Užtikrinkite, kad jūsų tolesnės sistemos žinotų, kada pasikeičia elemento būsena arba įvyksta talpinimo prieinamumo įvykis. PhotoRobot Cloud „Customer Webhooks“ kiekvieną įvykį pristato į jūsų galinius taškus, todėl integracijos išlieka grindžiamos įvykiais, o ne periodiniu duomenų užklausimu.

Šiuo metu veikiantys įvykiai:

• item.status.changed – patvirtintas vieno elemento fotografavimo būsenos pasikeitimas.
• item.status.bulk_changed — vienas įvykis po masinio būsenos pakeitimo Cloud aplinkoje.
• hosting.item.availability.changed — talpinama medija tapo parsisiunčiama arba nebeprieinama.
• webhook.subscription.test — tik siunčiant testą.

‍

‍

‍

Patikimas, įvykiais grindžiamas duomenų pristatymas

„Customer Webhooks“ PhotoRobot Cloud apima šias funkcijas:

• Siunčiamųjų webhook’ų prenumeratos, valdomos kartu su jūsų kūrėjų integracijomis.
• Pasirašytas HTTP pristatymas, kad gavėjai galėtų patikrinti autentiškumą.
• „Send test“ ir filtrai webhook prenumeratai ir parašo patikrai patvirtinti.
• Pristatymo žurnalas duomenų turiniui (payload), HTTP būsenai ir pakartotiniams bandymams peržiūrėti.
• Kūrėjų sąsaja skiltyje „Webhooks“ — webhook’ai ir pristatymai yra šalia API raktų.

‍

‍

‍

Kalbame jūsų kalba gamybinėms integracijoms

„Customer Webhooks“ – trūkstama grandis tarp robotizuoto fotografavimo ir pagrindinių įmonės duomenų sistemų. Webhook yra pasirašytas signalas, sąmoningai siunčiantis tik nedidelį duomenų kiekį. Gavus 2xx atsakymą, integracija pasiima dabartinį elementą iš REST v2 (pull.itemUrl / pull.deltaUrl). Webhook’ai gali pranešti leidėjui arba, po duomenų pasiėmimo, padėti jūsų komandai inicijuoti CDN talpyklos išvalymą ar atnaujinti skelbimą prekyvietėje. PhotoRobot Cloud dabar kalba jūsų kalba gamybinėms integracijoms.

‍

‍

‍

Pirma signalas, paskui duomenų pasiėmimas

Duomenų turinys sąmoningai išlieka nedidelis. Kiekvienas turinys nurodo įvykį, organizaciją ir (kai aktualu) elementą, taip pat pull.itemUrl ir pull.deltaUrl. Turinyje nėra vaizdų dvejetainių failų, pilnų aplankų medžių ar išsamaus produkto įrašo.

Kūrėjų įgyvendintinas modelis:

1. Gaukite POST užklausą ir patikrinkite X-PhotoRobot-Signature pagal neapdorotą užklausos turinį.
2. Greitai grąžinkite 2xx — DAM importą ar prekyvietės atnaujinimą atlikite savo vykdytuve (worker).
3. Pašalinkite dublikatus pagal įvykio ID. Pristatymas vykdomas bent vieną kartą (at-least-once).
4. Gaukite dabartinę būseną iš REST v2 hostingo naudodami pull URL adresus.

Būtent šis atskyrimas užtikrina patikimą integraciją. PhotoRobot nelaukia, kol bus baigta jūsų katalogo užduotis, o jūsų sistema niekada nelaiko pranešimo pačiu katalogu.

‍

‍

‍

Dažniausi „Customer Webhooks“ naudojimo pavyzdžiai

Dažniausi „Customer Webhooks“ naudojimo scenarijai PhotoRobot ekosistemoje:

• PIM arba DAM duomenų atnaujinimas. Prenumeruokite hosting.item.availability.changed. Kai talpinama medija tampa atsisiunčiama, gaukite itemUrl ir atnaujinkite produktą – sukimus, nuotraukas ir metaduomenis vienu žingsniu.
• Skelbimas prekyvietėje. Filtruokite talpinimo įvykius pagal „Became downloadable“. Skelbimą paskelbkite ar atnaujinkite tik tada, kai PhotoRobot iš tikrųjų gali pateikti vaizdus.
• Gamybos eigos matomumas. Prenumeruokite item.status.changed, kai jūsų ERP ar kokybės kontrolės (QC) lentai reikia žinoti, kad elementas perkeltas į būseną EDITED, APPROVED arba PUBLISHED – net dar prieš tai, kai talpinimas paruoštas.
• Masiniai kampanijų atnaujinimai. Po didelio būsenos pakeitimo Cloud sistemoje gaunamas vienas item.status.bulk_changed įvykis su deltaUrl. Sinchronizuokite paveiktą rinkinį, užuot laukę tūkstančių atskirų kiekvieno elemento webhook pranešimų.
• Talpyklos arba CDN panaikinimas. Kai talpinimas tampa prieinamas arba neprieinamas, išvalykite arba iš anksto įkraukite kelius, kuriuos jūsų internetinė parduotuvė jau žino. Webhook yra paleidiklis, o naujų URL šaltinis yra Hosting API.

‍

‍

‍

Kaip sukonfigūruoti „Customer Webhooks“

Norėdami nustatyti „Customer Webhooks“ sistemai PhotoRobot Cloud, atidarykite savo PhotoRobot Account Developers režimu ir sukurkite webhook prenumeratą skiltyje Webhooks. Tada nukreipkite prenumeratą į savo testavimo (staging) galinį tašką, kad patikrintumėte pirmąjį pristatymą.

‍

‍

1. Prisijunkite prie PhotoRobot Account ir atidarykite Developers → Webhooks.
2. Sukurkite webhook. Įklijuokite savo HTTPS galinį tašką, suteikite jam vidinį pavadinimą ir pasirinkite reikalingus įvykius.
3. Nukopijuokite pasirašymo paslaptį, kai ji pasirodys – ji rodoma vieną kartą, kol jos nepakeisite.
4. Spustelėkite Send test. Įsitikinkite, kad gautas webhook.subscription.test ir parašas patvirtinamas.
5. Atidarykite Delivery log, kad peržiūrėtumėte duomenų turinį (payload), HTTP būseną ir pakartotinius bandymus.
6. Pirmąją prenumeratą nukreipkite į testavimo (staging) galinį tašką.

‍

‍

Daugiau techninės informacijos, įskaitant developer contract ir parašo pavyzdžius, rasite PhotoRobot Developer Portal – Webhooks.

‍

‍