Uutuus: Customer Webhooks PhotoRobot Cloud -palveluun

Customer Webhooks PhotoRobot Cloud -palveluun

Kehittäjät ja IT-tiimit voivat nyt yhdistää PhotoRobot Cloud -palvelun DAM-, PIM- ja ERP-järjestelmiin tai räätälöityyn automaatioon allekirjoitettujen lähtevien webhookien avulla. PhotoRobot Cloud -palvelun Customer Webhooks tarjoaa luotettavan, tapahtumapohjaisen tiedonsiirron, joka varmistaa täyden yhteyden studion ja järjestelmien välillä.

‍

‍

‍

Yhdistä studio ja järjestelmät saumattomasti

Varmista, että kohdejärjestelmät saavat tiedon, kun kohteen tila muuttuu tai kun isännöinnin saatavuudessa tapahtuu muutos. PhotoRobot Cloud -palvelun Customer Webhooks toimittaa jokaisen tapahtuman päätepisteisiisi, jolloin integraatiot pysyvät tapahtumapohjaisina eivätkä turvaudu kyselyyn (polling).

Käytössä olevat tapahtumat:

• item.status.changed – yhden kohteen vahvistettu kuvauksen tilan muutos.
• item.status.bulk_changed – yksi tapahtuma Cloudin massatilamuutoksen jälkeen.
• hosting.item.availability.changed – isännöity media on muuttunut ladattavaksi tai poistunut saatavilta.
• webhook.subscription.test – vain testilähetys.

‍

‍

‍

Luotettava, tapahtumapohjainen tiedonsiirto

PhotoRobot Cloud -palvelun Customer Webhooks sisältää seuraavat ominaisuudet:

• Lähtevien webhookien tilaukset, joita hallitaan kehittäjäintegraatioiden yhteydessä.
• Allekirjoitettu HTTP-toimitus, jotta vastaanottajat voivat varmistaa aitouden.
• ”Send test” ja suodattimet webhook-tilauksen ja allekirjoituksen varmennuksen vahvistamiseen.
• Toimituslokki, josta voi tarkastaa payloadin, HTTP-tilan ja uudelleenyritykset.
• Kehittäjän käyttöliittymä Webhooks-kohdassa – webhookit ja toimitukset sijaitsevat API-avainten vieressä.

‍

‍

‍

Tuotantointegraatioiden kieltä puhuen

Customer Webhooks on puuttuva lenkki robotisoidun kuvauksen ja yrityksen tietojärjestelmien välillä. Webhook on allekirjoitettu signaali, joka sisältää tarkoituksella vain pienen payloadin. 2xx-vastauksen jälkeen integraatio hakee kohteen nykytilan REST v2:sta (pull.itemUrl / pull.deltaUrl). Webhookit voivat ilmoittaa julkaisijalle tai haun jälkeen auttaa tiimiäsi käynnistämään CDN-välimuistin tyhjennyksen tai päivittämään markkinapaikan listauksen. PhotoRobot Cloud puhuu nyt tuotantointegraatioiden kieltä.

‍

‍

‍

Ensin signaali, sitten haku

Payloadit pidetään tarkoituksella pieninä. Jokainen payload sisältää tapahtuman, organisaation ja (tarvittaessa) kohteen sekä pull.itemUrl- ja pull.deltaUrl-osoitteet. Payloadit eivät sisällä lainkaan kuvatiedostoja, kokonaisia kansiopuita tai täydellistä tuotetietuetta.

Kehittäjien tulisi toteuttaa seuraava malli:

1. Vastaanota POST-pyyntö ja varmista X-PhotoRobot-Signature-otsake raakadataa (raw body) vasten.
2. Palauta 2xx-vastaus nopeasti – tee DAM-tuonti tai markkinapaikkapäivitys omassa worker-prosessissasi.
3. Poista kaksoiskappaleet tapahtumatunnuksen (event ID) perusteella. Toimitus tapahtuu vähintään kerran (at-least-once).
4. Hae ajantasainen tila REST v2 -hostingista pull-URL-osoitteiden avulla.

Juuri tämä erottelu tekee integraatiosta luotettavan. PhotoRobot ei odota luettelotyösi valmistumista, eikä järjestelmäsi koskaan pidä ilmoitusta itse tuoteluettelona.

‍

‍

‍

Customer Webhooks -toiminnon yleisiä käyttöesimerkkejä

Yleisimpiä Customer Webhooks -toiminnon käyttötapauksia PhotoRobot-ekosysteemissä ovat:

• PIM- tai DAM-järjestelmän päivitys. Tilaa tapahtuma hosting.item.availability.changed. Kun hostattu media on ladattavissa, hae itemUrl ja päivitä tuote – kiertokuvat, still-kuvat ja metatiedot yhdellä kertaa.
• Markkinapaikkalistaus. Rajaa hosting-tapahtumat tapahtumaan ”Became downloadable”. Julkaise tai päivitä listaus vasta, kun PhotoRobot pystyy todella toimittamaan kuvat.
• Tuotannon tilanäkymä. Tilaa item.status.changed, kun ERP- tai laadunvalvontanäkymän on saatava tieto siitä, että kohde on siirtynyt tilaan EDITED, APPROVED tai PUBLISHED – jo ennen kuin hostaus on valmis.
• Massapäivitykset kampanjoihin. Kun Cloud-palvelussa tehdään laaja tilamuutos, saapuu yksi item.status.bulk_changed -tapahtuma, jonka mukana tulee deltaUrl. Päivitä muutosten koskemat kohteet kerralla sen sijaan, että odottaisit tuhansia kohdekohtaisia webhookeja.
• Välimuistin tai CDN:n mitätöinti. Kun hostauksen tila muuttuu saatavilla olevaksi tai poistuu saatavilta, tyhjennä tai esilämmitä ne polut, jotka verkkokauppasi jo tuntee. Webhook toimii laukaisijana; uusien URL-osoitteiden lähteenä on Hosting API.

‍

‍

‍

Customer Webhooks -toiminnon määrittäminen

Voit ottaa Customer Webhooks -toiminnon käyttöön PhotoRobot Cloud -palvelussa avaamalla PhotoRobot Account -tilisi Developers-tilassa ja luomalla webhook-tilauksen Webhooks-osiossa. Ohjaa tilaus sitten testiympäristösi päätepisteeseen ensimmäisen toimituksen varmistamiseksi.

‍

‍

1. Kirjaudu PhotoRobot Account -tilille ja avaa Developers → Webhooks.
2. Luo webhook. Liitä HTTPS-päätepisteesi, anna sille sisäinen nimi ja valitse tarvitsemasi tapahtumat.
3. Kopioi allekirjoitusavain, kun se tulee näkyviin – se näytetään vain kerran, kunnes vaihdat avaimen.
4. Napsauta Send test. Varmista, että webhook.subscription.test saapuu ja allekirjoitus tarkistuu.
5. Avaa Delivery log ja tarkista payload, HTTP-tila ja uudelleenyritykset.
6. Ohjaa ensimmäinen tilaus testiympäristön päätepisteeseen.

‍

‍

Lisää teknistä tietoa, kuten kehittäjäsopimus ja allekirjoitusesimerkit, on kohdassa PhotoRobot Developer Portal – Webhooks.

‍

‍