Pristatome: Klientų internetiniai kabliukai PhotoRobot Cloud

Klientų Webhook'ai PhotoRobot Cloud

Jūsų kūrėjai ir IT komandos dabar gali prijungti PhotoRobot Cloud prie jūsų DAM, PIM, ERP arba individualios automatizacijos su pasirašytais išeinančių webhook'ų sprendimais. Klientų webhook'ai PhotoRobot Cloud siūlo patikimą, įvykiais pagrįstą duomenų perdavimą – užtikrinant visišką ryšį tarp jūsų studijos ir sistemų.

‍

‍

‍

Uždarykite ciklą tarp savo studijos ir sistemų

Užtikrinkite, kad jūsų žemyninės sistemos žinotų, kai pasikeičia prekės būsena arba įvyksta hostingo prieinamumo įvykis. PhotoRobot Cloud klientų webhooks pristato kiekvieną įvykį į jūsų galutinius taškus, kad integracijos išliktų įvykių valdomos, o ne apklausų pagrindu.

Gyvi renginiai yra:

• item.status.changed – įvykdė užfiksavimo būsenos pakeitimą vienam elementui.
• item.status.bulk_changed — vienas įvykis po debesijos masinio statuso pakeitimo.
• hosting.item.availability.changed — talpinama medija tapo atsisiunčiama arba neprieinama.
• webhook.subscription.test — Siųsti tik testą.

‍

‍

‍

Patikimas, įvykiais grįstas duomenų perdavimas

Klientų interneto kabliukai PhotoRobot Cloud apima funkcijas:

• Outbound webhook prenumeratos valdomos kartu su jūsų kūrėjų integracijomis.
• Pasirašytas HTTP pristatymas , kad gavėjai galėtų patikrinti autentiškumą.
• "Siųsti testą" ir filtrus , patvirtinančius webhook prenumeratą ir parašo patvirtinimą.
• Pristatymo žurnalas , skirtas peržiūrėti naudingąją apkrovą, HTTP būseną ir bandymus iš naujo.
• Kūrėjo vartotojo sąsaja po Webhooks — webhookai ir pristatymai veikia šalia API raktų.

‍

‍

‍

Kalbėjimas savo kalba gamybos integracijoms

Klientų Webhook'ai yra trūkstama grandis tarp robotizuoto fiksavimo ir įmonės registravimo sistemų. Webhook'as yra pasirašytas signalas, specialiai nešantis tik mažus krovinius. Po 2xx integracijos ištraukia dabartinį elementą iš REST v2 (pull.itemUrl / pull.deltaUrl). Webhook'ai gali informuoti leidėją arba, po traukimo, padėti jūsų komandai pradėti CDN valymą ar atnaujinti prekyvietės skelbimą. PhotoRobot Cloud dabar kalba jūsų kalba gamybinėms integracijoms.

‍

‍

‍

Signalas, tada trauka

Kroviniai sąmoningai lieka maži. Kiekvienas krovinys nurodo įvykį, organizaciją ir (kai aktualu) daiktą, taip pat pull.itemUrl ir pull.deltaUrl. Kroviniai neturi vaizdų dvejetainių failų, pilno aplankų medžių ar pilno produkto įrašo.

Šablonas, kurį turėtų įgyvendinti kūrėjai, yra:

1. Gaukite POST ir patikrinkite X-PhotoRobot-Signature su žaliu kūnu.
2. Greitai grąžinkite 2xx — atlikite DAM importą arba rinkos atnaujinimą savo darbe.
3. Deduplikuokite pagal įvykio ID. Pristatymas atliekamas bent vieną kartą.
4. Atsisiųskite dabartinę būseną iš REST v2 talpinimo naudodami pull URL.

Būtent šis padalijimas daro integraciją patikimą. PhotoRobot nelaukia, kol baigsis katalogo darbas, o jūsų sistema niekada nelaiko pranešimo katalogu.

‍

‍

‍

Dažniausi klientų webhook'ų naudojimo pavyzdžiai

Dažniausi klientų Webhook'ų naudojimo atvejai PhotoRobot ekosistemoje yra šie:

• PIM arba DAM atnaujinimas. Prenumeruokite hosting.item.availability.changed. Kai talpinama medija taps atsisiunčiama, atsisiųskite itemUrl ir atnaujinkite produktą — vienu perėjimu – sukimus, nuotraukas ir metaduomenis.
• Prekyvietės įrašas. Filtruokite renginių organizavimą į "Tapo atsisiunčiama". Skelbimą paskelbkite arba atnaujinkite tik tada, kai PhotoRobot galės pateikti vaizdus.
• Gamybos lentos matomumas. Prenumeruokite item.status.changed, kai jūsų ERP arba QC valdyba turi žinoti, kad elementas perkeltas į REDAGUOTĄ, PATVIRTINTĄ ar PASKELBTĄ — net prieš talpinimo paruošimą.
• Masiniai kampanijos atnaujinimai. Po didelio būsenos pokyčio debesyje, vienas item.status.bulk_changed įvykis pasirodo su deltaUrl. Pasivykite paveiktą rinkinį, o ne tikėkitės tūkstančių webhook'ų kiekvienam daiktui.
• Talpyklos arba CDN nevalidavimas. Kai talpinimas persijungia į prieinamas arba neprieinamas, išvalykite arba sušildykite kelius, kuriuos jūsų parduotuvė jau žino. Webhook yra trigeris; Hosting API yra naujų URL šaltinis.

‍

‍

‍

Kaip konfigūruoti savo klientų webhook'us

Norėdami nustatyti Customer Webhooks PhotoRobot Cloud platformai, atidarykite savo PhotoRobot paskyrą kūrėjų režimu ir naudokite Webhooks, kad sukurtumėte webhook prenumeratą. Tada nukreipkite prenumeratą į savo staging galinį tašką, kad patvirtintumėte pirmąjį pristatymą.

‍

‍

1. Prisijunkite prie PhotoRobot paskyros ir atidarykite kūrėjus → Webhooks.
2. Sukurk webhooką. Įklijuok savo HTTPS galinį tašką, suteik vidinį pavadinimą ir pasirink reikalingus įvykius.
3. Nukopijuokite pasirašymo paslaptį, kai ji pasirodo – ji rodoma vieną kartą, kol ją pasukate.
4. Spauskite Siųsti testą. Patvirtinkite, kad webhook.subscription.test atkeliauja ir parašas patvirtinamas.
5. Atidarykite pristatymo žurnalą , kad patikrintumėte naudingąją apkrovą, HTTP būseną ir bandytumėte pakartotinai.
6. Pirmąją prenumeratą nukreipkite į stadijos galinį tašką.

‍

‍

Daugiau techninės informacijos, įskaitant kūrėjų sutarčių ir parašų pavyzdžius, rasite PhotoRobot Developer Portal – Webhooks.

‍

‍