Nippreżentaw: Customer Webhooks għal PhotoRobot Cloud

Customer Webhooks għal PhotoRobot Cloud

L-iżviluppaturi u t-timijiet tal-IT tagħkom issa jistgħu jgħaqqdu PhotoRobot Cloud mad-DAM, mal-PIM, mal-ERP jew mal-awtomazzjoni personalizzata tagħkom permezz ta’ webhooks ħerġin iffirmati. Il-customer webhooks f’PhotoRobot Cloud joffru twassil affidabbli tad-data bbażat fuq l-avvenimenti – u b’hekk tiżguraw konnettività sħiħa bejn l-istudjo u s-sistemi tagħkom.

‍

‍

‍

Agħlqu ċ-Ċirku bejn l-Istudjo u s-Sistemi Tagħkom

Kunu żguri li s-sistemi downstream tagħkom ikunu jafu meta jinbidel l-istatus ta’ oġġett jew meta jseħħ avveniment ta’ disponibbiltà tal-hosting. Il-Customer Webhooks ta’ PhotoRobot Cloud iwasslu kull avveniment lill-endpoints tagħkom, sabiex l-integrazzjonijiet jibqgħu bbażati fuq l-avvenimenti – mhux fuq il-polling.

L-avvenimenti attivi huma:

• item.status.changed – bidla kkonfermata fl-istatus tal-qbid ta’ oġġett wieħed.
• item.status.bulk_changed — avveniment wieħed wara bidla bulk fl-istatus fil-Cloud.
• hosting.item.availability.changed — il-media ospitata saret disponibbli għat-tniżżil jew m’għadhiex disponibbli.
• webhook.subscription.test — Għall-“Send test” biss.

‍

‍

‍

Twassil Affidabbli tad-Data Bbażat fuq l-Avvenimenti

Il-Customer Webhooks f’PhotoRobot Cloud jinkludu funzjonalitajiet għal:

• Sottoskrizzjonijiet ta’ webhooks ħerġin ġestiti flimkien mal-integrazzjonijiet tal-iżvilupp tagħkom.
• Twassil HTTP iffirmat biex ir-riċevituri jkunu jistgħu jivverifikaw l-awtentiċità.
• “Send test” u filtri biex tikkonfermaw is-sottoskrizzjoni tal-webhook u l-verifika tal-firma.
• Log tat-twassil biex tispezzjonaw il-payload, l-istatus HTTP u r-tentattivi mill-ġdid.
• UI tal-iżviluppatur taħt Webhooks — il-webhooks u t-twassil jinsabu ħdejn l-API keys.

‍

‍

‍

Nitkellmu l-Lingwa Tagħkom għall-Integrazzjonijiet tal-Produzzjoni

Il-Customer Webhooks huma r-rabta nieqsa bejn il-qbid robotizzat u s-sistemi ta’ rekord tal-kumpanija. Il-webhook huwa sinjal iffirmat li apposta jġorr payloads żgħar biss. Wara 2xx, l-integrazzjoni tiġbed l-oġġett kurrenti minn REST v2 (pull.itemUrl / pull.deltaUrl). Il-webhooks jistgħu jinnotifikaw publisher jew, wara l-pull, jgħinu lit-tim tagħkom jibda purge tas-CDN jew jaġġorna listing f’marketplace. PhotoRobot Cloud issa titkellem il-lingwa tagħkom għall-integrazzjonijiet tal-produzzjoni.

‍

‍

‍

Sinjal, Imbagħad Pull

Il-payloads jibqgħu żgħar apposta. Kull payload isemmi l-avveniment, l-organizzazzjoni u (meta jkun rilevanti) l-oġġett, flimkien ma’ pull.itemUrl u pull.deltaUrl. Il-payloads ma jġorrux binaries tal-immaġini, siġar sħaħ tal-folders jew rekord sħiħ tal-prodott.

Il-mudell li l-iżviluppaturi għandhom jimplimentaw huwa dan:

1. Irċievu l-POST u vverifikaw X-PhotoRobot-Signature mal-body mhux ipproċessat.
2. Irritornaw 2xx malajr — agħmlu l-importazzjoni fid-DAM jew l-aġġornament tal-marketplace fil-worker tagħkom stess.
3. Neħħu d-duplikati skont l-ID tal-avveniment. It-twassil isir mill-inqas darba.
4. Ġibdu l-istat kurrenti mill-hosting REST v2 permezz tal-pull URLs.

Hija din is-separazzjoni li tagħmel l-integrazzjoni affidabbli. PhotoRobot ma jistennix li l-ħidma tal-katalgu tiegħek tkun lesta, u s-sistema tiegħek qatt ma tqis in-notifika bħala l-katalgu nnifsu.

‍

‍

‍

Eżempji Komuni tal-Użu tal-Customer Webhooks

L-aktar każijiet ta’ użu komuni tal-Customer Webhooks fl-ekosistema ta’ PhotoRobot jinkludu:

• Aġġornament tal-PIM jew tad-DAM. Issottoskrivi għal hosting.item.availability.changed. Meta l-media ospitata ssir disponibbli għat-tniżżil, ġib itemUrl u aġġorna l-prodott — spins, stills u metadata f’pass wieħed.
• Lista fil-marketplace. Iffiltra l-avvenimenti tal-hosting għal “Became downloadable.” Ippubblika jew aġġorna l-lista biss wara li PhotoRobot ikun jista’ tassew iservi l-immaġini.
• Viżibilità tal-bord tal-produzzjoni. Issottoskrivi għal item.status.changed meta l-ERP jew il-bord tal-QC tiegħek jeħtieġ ikun jaf li oġġett ċaqlaq għal EDITED, APPROVED jew PUBLISHED — anke qabel ma jkun lest il-hosting.
• Aġġornamenti bl-ingrossa tal-kampanji. Wara bidla kbira fl-istatus f’Cloud, jasal avveniment wieħed item.status.bulk_changed bi deltaUrl. Aġġorna s-sett affettwat minflok ma tistenna eluf ta’ webhooks għal kull oġġett.
• Invalidazzjoni tal-cache jew tas-CDN. Meta l-hosting jinbidel għal disponibbli jew mhux disponibbli, naddaf jew saħħan minn qabel il-mogħdijiet li l-vetrina tiegħek diġà taf bihom. Il-webhook huwa l-attivatur; Hosting API huwa s-sors tal-URLs il-ġodda.

‍

‍

‍

Kif Tikkonfigura l-Customer Webhooks Tiegħek

Biex twaqqaf Customer Webhooks għal PhotoRobot Cloud, iftaħ il-PhotoRobot Account tiegħek fil-modalità Developers u uża Webhooks biex toħloq sottoskrizzjoni ta’ webhook. Imbagħad, orjenta s-sottoskrizzjoni lejn l-endpoint tal-istaging tiegħek biex tivverifika l-ewwel kunsinna.

‍

‍

1. Idħol f’PhotoRobot Account u iftaħ Developers → Webhooks.
2. Oħloq webhook. Waħħal l-endpoint HTTPS tiegħek, agħtih isem intern u agħżel l-avvenimenti li għandek bżonn.
3. Ikkopja s-signing secret meta jidher — jintwera darba biss sakemm iddawwar.
4. Ikklikkja Send test. Ikkonferma li webhook.subscription.test jasal u li l-firma tiġi vverifikata.
5. Iftaħ id-Delivery log biex tispezzjona l-payload, l-istatus HTTP u r-retries.
6. Orjenta l-ewwel sottoskrizzjoni lejn endpoint tal-istaging.

‍

‍

Għal aktar informazzjoni teknika, inklużi eżempji tal-kuntratt tal-iżviluppatur u tal-firma, irreferi għal PhotoRobot Developer Portal – Webhooks.

‍

‍