Esittely: Asiakasverkkokoukut PhotoRobot Cloudille

Asiakasverkkokoukut PhotoRobot Cloudille

Kehittäjäsi ja IT-tiimisi voivat nyt liittää PhotoRobot Cloudin DAM-, PIM-, ERP- tai räätälöityyn automaatioon signeeratuilla lähtevillä webhookeilla. Asiakasverkkokoukut PhotoRobot Cloudissa tarjoavat luotettavan, tapahtumalähtöisen datan toimituksen – varmistaen täyden yhteyden studiosi ja järjestelmien välillä.

‍

‍

‍

Sulje silmukka studiosi ja järjestelmien välillä

Varmista, että alavirran järjestelmäsi tietävät, milloin kohteen tila muuttuu tai tapahtuu hosting-saatavuustapahtuma. PhotoRobot Cloud Customer Webhookit toimittavat jokaisen tapahtuman päätepisteillesi, jotta integraatiot pysyvät tapahtumavetoisina – eivät kyselypohjaisina.

Live-tapahtumat ovat:

• item.status.changed – sitoutunut kaappaustilan muutos yhdelle esineelle.
• item.status.bulk_changed — yksi tapahtuma Cloudin massastatusmuutoksen jälkeen.
• hosting.item.availability.changed — isännöidyn median lataus tai käyttö pois käytöstä.
• webhook.subscription.test — Lähetä vain testi.

‍

‍

‍

Luotettava, tapahtumalähtöinen tiedonsiirto

PhotoRobot Cloudin asiakasverkkokoukut sisältävät ominaisuuksia:

• Lähtevät webhook-tilaukset hallitaan yhdessä kehittäjäintegraatioiden kanssa.
• Allekirjoitettu HTTP-toimitus , jotta vastaanottajat voivat varmistaa aitouden.
• "Lähetä testi" ja suodattimet webhook-tilauksen ja allekirjoituksen vahvistuksen varmistamiseksi.
• Toimitusloki hyötykuorman, HTTP-tilan ja kokeilujen tarkistamiseen.
• Kehittäjäkäyttöliittymä Webhooksin alla — webhookit ja toimitukset ovat API-avainten vieressä.

‍

‍

‍

Kielisi puhuminen tuotantointegraatioita varten

Asiakasverkkokoukut ovat puuttuva lenkki robotisoidun kaappauksen ja yrityksen rekisterijärjestelmien välillä. Webhook on allekirjoitettu signaali, joka kuljettaa tarkoituksella vain pieniä hyötykuormia. 2xx:n jälkeen integraatio hakee nykyisen kohteen REST v2:sta (pull.itemUrl / pull.deltaUrl). Webhookit voivat ilmoittaa julkaisijalle tai haun jälkeen auttaa tiimiäsi käynnistämään CDN-puhdistuksen tai päivittämään markkinapaikan listausta. PhotoRobot Cloud puhuu nyt sinun kieltäsi tuotantointegraatioissa.

‍

‍

‍

Signaali, sitten vetovoima

Hyötykuormat pysyvät tarkoituksella pieninä. Jokainen hyötykuorma nimeää tapahtuman, organisaation ja (tarvittaessa) kohteen, sekä pull.itemUrl ja pull.deltaUrl. Hyötykuormat eivät kanna kuvabinäärejä, kokonaisia kansiopuita tai täydellistä tuotetietuetta.

Mallin kehittäjien tulisi toteuttaa seuraavasti:

1. Vastaanota POST ja varmista X-PhotoRobot-Signature raakarunkoa vastaan.
2. Palauta 2xx nopeasti — tee DAM-tuonti tai markkinapaikkapäivitys omassa työntekijässäsi.
3. Deduplikaatti tapahtumatunnisteen mukaan. Toimitus tapahtuu vähintään kerran.
4. Hae nykyinen tila REST v2 -hostingista käyttämällä pull-URL-osoitteita.

Juuri tämä jako tekee integraatiosta luotettavan. PhotoRobot ei odota katalogityön valmistumista, eikä järjestelmäsi koskaan käsittele ilmoitusta katalogina.

‍

‍

‍

Yleisiä esimerkkejä asiakkaiden webhookeista käytössä

Yleisimmät käyttötapaukset asiakasverkkokoukuille PhotoRobot-ekosysteemissä ovat:

• PIM- tai DAM-päivitys. Tilaa hosting.item.availability.changed. Kun isännöity media tulee ladattavaksi, hae itemUrl ja päivitä tuote — pyöritykset, pysäytykset ja metatiedot yhdellä kertaa.
• Markkinapaikan listaus. Suodata tapahtumien isännöinti muotoon "Tuli ladattavaksi." Julkaise tai päivitä listaus vasta sen jälkeen, kun PhotoRobot on oikeasti pystynyt näyttämään kuvat.
• Tuotantolautakunnan näkyvyys. Tilaa item.status.changed, kun ERP- tai QC-lautakuntasi tarvitsee tietää, että tuote on siirretty MUOKATTU, HYVÄKSYTTY tai JULKAISTU — jo ennen kuin isännöinti on valmis.
• Laajemmat kampanjapäivitykset. Suuren tilamuutoksen jälkeen Cloudissa saapuu yksi item.status.bulk_changed tapahtuma deltaUrl:n kanssa. Seuraa vaikutusalue sen sijaan, että odottaisit tuhansia webhookeja per kohde.
• Välimuistin tai CDN:n mitätöinti. Kun hosting vaihtaa saatavuuteen tai ei-saatavilla, tyhjennä tai lämmitä ne reitit, jotka kauppasi jo tuntee. Webhook on laukaisija; Hosting-API on uusien URL-osoitteiden lähde.

‍

‍

‍

Kuinka konfiguroida asiakkaan webhookit

Asettaaksesi Customer Webhookit PhotoRobot Cloudille, avaa PhotoRobot-tilisi kehittäjä-tilassa ja käytä Webhooksia luodaksesi webhook-tilauksen. Sitten osoita tilaus staging-päätepisteelle varmistaaksesi ensimmäisen toimituksen.

‍

‍

1. Kirjaudu PhotoRobot-tilille ja avaa Developers → Webhooks.
2. Luo webhook. Liitä HTTPS-päätepisteesi, anna sille sisäinen nimi ja valitse tarvitsemasi tapahtumat.
3. Kopioi allekirjoitussalaisuus, kun se ilmestyy — se näytetään kerran, kunnes käännät sen.
4. Klikkaa Lähetä testi. Vahvista, että webhook.subscription.test saapuu ja allekirjoitus vahvistuu.
5. Avaa toimitusloki tarkastaaksesi hyötykuorman, HTTP-tilan ja kokeilut.
6. Suuntaa ensimmäinen tilaus vaiheen päätepisteelle.

‍

‍

Lisätietoja, mukaan lukien kehittäjäsopimus- ja allekirjoitusesimerkit, löydät PhotoRobot Developer Portal – Webhooksista.

‍

‍