Introduzzjoni: Webhooks tal-Klijenti għal PhotoRobot Cloud

Webhooks tal-Klijent għal PhotoRobot Cloud

L-iżviluppaturi u t-timijiet IT tiegħek issa jistgħu jgħaqqdu PhotoRobot Cloud mal-DAM, PIM, ERP, jew awtomazzjoni personalizzata tiegħek b'webhooks outbound iffirmati. Il-webhooks tal-klijenti f'PhotoRobot Cloud joffru kunsinna ta' data affidabbli u mmexxija minn avvenimenti – li tiżgura konnettività sħiħa bejn l-istudjo u s-sistemi tiegħek.

‍

‍

‍

Agħlaq il-Loop bejn l-Istudjo Tiegħek u s-Sistemi

Żgur li s-sistemi tiegħek ta' taħt ikunu jafu meta jinbidel l-istatus ta' oġġett jew jiġri avveniment ta' disponibbiltà tal-hosting. PhotoRobot Cloud Customer Webhooks iwasslu kull avveniment lill-endpoints tiegħek sabiex l-integrazzjonijiet jibqgħu mmexxija mill-avvenimenti – mhux bbażati fuq polling.

L-avvenimenti live huma:

• item.status.changed – Bidla ta' status ta' qbid fuq oġġett wieħed.
• item.status.bulk_changed — avveniment wieħed wara bidla fl-istatus tal-Cloud bulk.
• hosting.item.availability.changed — il-midja ospitata saret titniżżel jew ma kinitx disponibbli.
• webhook.subscription.test — Jibgħat test biss.

‍

‍

‍

Kunsinna ta' Data Affidabbli u Mmexxija minn Avvenimenti

Il-Webhooks tal-Klijenti f'PhotoRobot Cloud jinkludu karatteristiċi għal:

• Abbonamenti outbound webhook immaniġġjati flimkien mal-integrazzjonijiet tal-iżviluppaturi tiegħek.
• Kunsinna HTTP iffirmata sabiex ir-riċevituri jkunu jistgħu jivverifikaw l-awtentiċità.
• "Ibgħat it-test" u filtri biex jikkonfermaw is-sottoskrizzjoni tal-webhook u l-verifika tas-firma.
• Log ta' kunsinna biex jivverifika l-payload, l-istatus HTTP, u r-ritratti ripetuti.
• UI għall-iżviluppaturi taħt Webhooks — webhooks u deliveries jgħixu ħdejn il-keys API.

‍

‍

‍

Kif titkellem il-Lingwa Tiegħek għal Integrazzjonijiet tal-Produzzjoni

Il-Webhooks tal-Klijent huma l-ħolqa nieqsa bejn il-qbid robotizzat u s-sistemi ta' rekord tal-kumpanija. Il-webhook huwa sinjal iffirmat, li jġorr biss payloads żgħar apposta. Wara 2xx, l-integrazzjoni tneħħi l-oġġett attwali minn REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks jistgħu jinnotifikaw pubblikatur, jew, wara t-tiġririja, jiffaċilitaw lit-tim tiegħek biex jibda purge ta' CDN jew jaġġorna lista tas-suq. PhotoRobot Cloud issa jitkellem bil-lingwa tiegħek għall-integrazzjonijiet tal-produzzjoni.

‍

‍

‍

Sinjal, imbagħad ġbid

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

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

1. Irċievi l-POST u ivverifika X-PhotoRobot-Signature kontra l-ġisem raw.
2. Erġa' lura 2xx malajr — agħmel l-importazzjoni DAM jew l-aġġornament tas-suq fuq il-ħaddiem tiegħek stess.
3. Id-duplikazzjoni skont l-ID tal-avveniment. Il-kunsinna ssir mill-inqas darba.
4. Ħu l-istat attwali mill-hosting REST v2 billi tuża l-URL ta' pull.

Dik il-qsim huwa dak li jagħmel l-integrazzjoni affidabbli. PhotoRobot ma tistenniex li l-ħidma tal-katalgu tiegħek tispiċċa, u s-sistema tiegħek qatt ma tittratta notifika bħala l-katalgu.

‍

‍

‍

Eżempji Komuni ta' Webhooks tal-Klijenti Użati

L-aktar każijiet ta' użu komuni għall-Customer Webhooks fl-ekosistema PhotoRobot jinkludu:

• PIM jew DAM refresh. Abbona għal hosting.item.availability.changed. Meta l-midja ospitata ssir downloadable, iġbed itemUrl u aġġorna l-prodott — spins, stills, u metadata f'pass wieħed.
• Lista tas-Suq. Iffiltra l-avvenimenti tal-hosting għal "Saret downloadable." Ippubblika jew aġġorna l-lista biss wara li PhotoRobot jista' jservi l-immaġini.
• Viżibilità tal-bord tal-produzzjoni. Abbona għal item.status.changed meta l-bord ERP jew QC tiegħek jeħtieġ jaf li oġġett ġie mċaqlaq għal EDITED, APPROVAT, jew IPPUBBLIKAT — anke qabel ma jkun lest l-ospitalità.
• Aġġornamenti tal-kampanja bl-ingrossa. Wara bidla kbira fl-istatus fil-Cloud, jiġi avveniment item.status.bulk_changed wieħed b'deltaUrl. Aqbad is-sett affettwat minflok tistenna eluf ta' webhooks għal kull oġġett.
• Invalidazzjoni ta' cache jew CDN. Meta l-hosting jinbidel għal disponibbli jew mhux disponibbli, neħħi jew sħun it-toroq li l-ħanut tiegħek diġà jaf. Il-webhook huwa l-iskantatur; L-API tal-hosting hija s-sors tal-URLs ġodda.

‍

‍

‍

Kif Tikkonfigura l-Webhooks tal-Klijent Tiegħek

Biex tissettja Customer Webhooks għal PhotoRobot Cloud, iftaħ il-kont PhotoRobot tiegħek fil-modalità Developers u uża Webhooks biex toħloq abbonament webhook. Imbagħad, ippunta l-abbonament lejn il-punt ta' staging tiegħek biex tivverifika l-ewwel kunsinna.

‍

‍

1. Idħol fil-Kont PhotoRobot u iftaħ Developers → Webhooks.
2. Oħloq webhook. Ippastja l-endpoint HTTPS tiegħek, agħtih isem intern, u agħżel l-avvenimenti li għandek bżonn.
3. Ikkopja s-sigriet tas-sinjatura meta jidher — jidher darba sakemm iddurha.
4. Ikklikkja Ibgħat test. Ikkonferma li wasal webhook.subscription.test u s-sinjatura tivverifika.
5. Iftaħ il-log tal-Delivery biex tispjezzjona l-payload, l-istatus HTTP, u r-ritratti ripetuti.
6. Poġġi l-ewwel abbonament f'punt ta' tmiem ta' staging.

‍

‍

Għal aktar informazzjoni teknika inkluż eżempji ta' kuntratti ta' żviluppaturi u sinjaturi, ara PhotoRobot Developer Portal – Webhooks.

‍

‍