Media API
GS1 Data uudistaa media-aineistojen hallinnan siirtymällä erillisestä Media API:sta tuotepohjaiseen JSON-rajapintaan, jossa mediatiedot ovat osa tuotetietoa. Uusi ratkaisu yhtenäistää attribuutit, helpottaa ylläpitoa ja mahdollistaa tuotetietojen tehokkaamman hallinnan ja laajentamisen tulevaisuudessa.
Nykytila: media-aineistojen ylläpito JSON-rajapinnalla
Toimintaperiaate
Rajapinnan kautta on mahdollista ylläpitää tuotteiden media-aineistoja erillään muusta tuotetiedosta.
Haaste
• Historiallisista syistä tuotetiedoista erillään
• Attribuutit eivät ole yhteneväisiä muun tuotetiedon kanssa
• Ei hakutoimintoa
• Media-aineiston löyhä relaatio tuotteeseen. Tuotteeseen liittyvien media-aineistojen selvittäminen vaikeaa
Uusi HTTPS-pohjainen JSON-tuotetietorajapinta
HTTPS JSON API
• Suunnitelmissa kaikkien tuotetietojen ylläpitämisen mahdollistava JSON API
• Ensimmäisessä vaiheessa mediaan liittyvät toiminnot
Hyödyt
• Attribuutit yhteneväiset muun tuotedatan kanssa
• Tulevaisuudessa mahdollistaa muidenkin tuotetietojen ylläpitämisen
• Helpottaa ylläpitoa
Alustava ratkaisuehdotus
Erillinen Media API poistuu. Jatkossa mediaaineistoja ylläpidetään osana tuotteen tietoja.
Tunnistautuminen API-avaimella, ei erillistä kirjautumista
/api/sdp/
• Tuotetietojen haku ja nouto tuotteittain, sisältäen mediatiedot
• Haluttujen attribuuttien päivitys tuotteelle, ensivaiheessa vain mediatiedot
Muutokset median ylläpidossa
Vanha Media API Tiedostopohjainen
1. Lähetetään uusi tiedosto
2. Ylläpidetään tiedostolle GTIN-koodi ja muut tarvittavat tiedot
3. Lisätään mediatiedosto julkaistulle tuotteelle
• Jos julkaistua tuotetta ei löydy, tapahtuu virhe
Mahdollisten virheiden syiden tunnistaminen ja tuotteella olevien muiden mediaaineistojen hakeminen hankalaa
Uusi tuotetietorajapinta
Tuotepohjainen
1. Haetaan tuote GTIN-koodilla
• Haetulle tuotteelle palautetaan kaikki tuotetiedot ja tuotteeseen liittyvät media-aineistot
2. Lisätään löydetylle tuotteelle mediaaineisto lisätietoineen