Fa'alauiloaina: Tagata fa'atau Webhooks mo PhotoRobot Cloud
PhotoRobot fa'alauiloa tagata fa'atau Webhooks mo PhotoRobot Cloud e fa'afeso'ota'i lau DAM, PIM, ERP, po'o le fa'aautomatika fa'apitoa ma saini outbound webhooks.
Tagata fa'atau Webhooks mo PhotoRobot Cloud
E mafai nei e au atina'e ma au IT ona fa'afeso'ota'i le PhotoRobot Cloud i lau DAM, PIM, ERP, po'o le fa'aautomatika fa'apitoa ma saini webhooks i fafo. Tagata fa'atau webhooks i PhotoRobot Cloud ofoina fa'atuatuaina, fa'amaumauga fa'amaumauga tu'uina atu - fa'amautinoaina le feso'ota'iga atoa i le va o lau potu ma faiga.

Tapuni le matasele i le va o lau potu su'esu'e ma masini
Ia mautinoa e iloa e au faiga i lalo le taimi e suia ai se tulaga o le aitema po'o se mea e tupu i le talimalo. PhotoRobot Cloud Customer Webhooks tu'uina atu mea ta'itasi i au i'uga ina ia tumau pea le tu'ufa'atasia o mea na tutupu - ae le o le palota.
O mea na tutupu o le:
- item.status.changed – suiga o le tulaga o le pu'eina o le tautinoga i luga o se aitema e tasi.
- item.status.bulk_changed — tasi le mea na tupu ina ua mae'a le suiga o le tulaga tele o Cloud.
- hosting.item.availability.changed — o ala o faasalalauga o loo talimalo na oo ina mafai ona sii mai pe le o maua.
- webhook.subscription.test — Auina atu na o le suega.

Fa'atuatuaina, Fa'amaumauga
Tagata fa'atau Webhooks i PhotoRobot Cloud aofia ai foliga mo:
- Outbound webhook saofaga fa'atautaia fa'atasi ai ma au tu'ufa'atasia atina'e.
- Saini HTTP kilivaina ina ia mafai ai e tagata e mauaina ona fa'amaonia le moni.
- "Auina atu le su'ega" ma faamama e fa'amaonia ai le saofaga o le webhook ma le fa'amaoniga o saini.
- Fa'apipi'i fa'amaumauga e siaki ai le uta, HTTP tulaga, ma toe fa'aleleia.
- Atina'e UI i lalo o Webhooks — webhooks ma kilivaina ola i tafatafa o API ki.

Tautala i lau gagana mo gaosiga tu'ufa'atasia
Webhooks tagata fa'atau o le feso'ota'iga o lo'o misi i le va o le pu'eina o robotized ma le kamupani faiga o fa'amaumauga. O le webhook o se fa'ailoga saini, o lo'o tauaveina na o ni uta laiti i le fa'amoemoe. A mae'a le 2xx, o le tu'ufa'atasia e toso le aitema o lo'o i ai nei mai le REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks mafai ona logoina se tagata lolomitusi, pe, pe a mae'a le toso, fa'afaigofie lau 'au i le amataina o le CDN fa'amamaina po'o le fa'afouina o se lisi o maketi. PhotoRobot Cloud o lo'o tautala nei i lau gagana mo tu'ufa'atasia gaosiga.

O se faailoga, ona sosoo ai lea ma se toso
Payloads tumau laiti i le faamoemoe. Payload taitasi faaigoaina le mea na tupu, le faalapotopotoga, ma (pe a talafeagai) le aitema, faaopoopo pull.itemUrl ma pull.deltaUrl. Payloads e le tauaveina ata binaries, laau faila atoa, po o se faamaumauga atoa o oloa.
O le mamanu e tatau ona fa'atinoina e le au atina'e o:
- Maua le POST ma fa'amaonia le X-PhotoRobot-Signature e fa'asaga i le tino mata.
- Toe fa'afo'i vave le 2xx — fai le DAM import po'o le maketi fa'afouina i lau oe lava tagata faigaluega.
- Deduplicate e ala i le mea na tupu ID. O le faaooina atu e le itiiti ifo ma le tasi.
- Aumai le tulaga o lo'o i ai nei mai le REST v2 talimalo e fa'aaoga ai le toso URL.
O lena vaeluaga o le mea lea e fa'atuatuaina ai le tu'ufa'atasia. PhotoRobot e le fa'atali mo lau galuega fa'amaumauga e mae'a, ma o lau faiga e le togafitia se fa'asilasilaga e pei o le lisi.

Fa'ata'ita'iga masani o tagata fa'atau webhooks o lo'o fa'aaogaina
O le sili ona taatele fa'aaogaina mataupu mo tagata fa'atau Webhooks i le PhotoRobot ecosystem aofia ai:
- PIM po'o le DAM fa'afouina. Lesitala i le hosting.item.availability.changed. A mafai ona sii mai le aufaasālalau, toso itemUrl ma fa'afou le oloa — spins, stills, ma metadata i le tasi pasi.
- Lisi o maketi. Fa'amama mea na tutupu i le "Mafai ona sii mai." Fa'asalalau pe fa'afouina le lisi pe a mae'a ona mafai e PhotoRobot ona tu'uina atu ata.
- Va'aia o le laupapa gaosiga. Lesitala i le item.status.changed pe a mana'omia e lau ERP po'o le QC board ona iloa se aitema na siitia i le EDITED, APPROVED, po'o le PUBLISHED — e tusa lava pe a'o le'i sauni le talimalo.
- Fa'afouga tele o tauiviga. Ina ua mae'a se suiga tele i le Cloud, o le tasi item.status.bulk_changed mea na tupu e taunu'u mai ma se deltaUrl. Pu'eina le seti na a'afia nai lo le fa'amoemoeina o le faitau afe o webhooks i le aitema.
- Cache po'o le CDN fa'aleaogaina. Pe a fa'apipi'i i avanoa pe le maua, fa'amama pe fa'amafanafana auala ua uma ona iloa e lau faleoloa. O le webhook o le fa'aosofia; O le Hosting API o le punavai o URL fou.

Fa'afefea ona fa'apipi'i lau 'upega tafa'ilagi
Ina ia setiina Customer Webhooks mo PhotoRobot Cloud, tatala lau PhotoRobot Account i le Developers mode ma fa'aaoga Webhooks e fausia ai se saofaga webhook. Ona fa'asino lea o le saofaga i lau fa'ata'ita'iga e fa'amaonia ai le muamua kilivaina.

- Saini i totonu i PhotoRobot teuga tupe ma tatala Developers → Webhooks.
- Fausia se webhook. Fa'apipi'i lau HTTPS endpoint, tu'uina atu i ai se igoa i totonu, ma filifili mea na tutupu e te mana'omia.
- Kopi le mea lilo o le saini pe a aliali mai — e fa'aalia fa'atasi se'ia o'o ina e fa'ata'amilomiloina.
- Kiliki le Send test. Confirm webhook.subscription.test taunuu ma faamaonia le saini.
- Tatala le faaogalaau o le faaooina atu e siaki ai le uta, tulaga HTTP, ma retries.
- Fa'asino le saofaga muamua i se fa'ata'ita'iga fa'aiuga.

Mo nisi fa'amatalaga fa'apitoa e aofia ai konekarate atina'e ma saini fa'ata'ita'iga, va'ai i le PhotoRobot Developer Portal – Webhooks.

