API-yhteys
GS1 Data uudistaa tuotetietojen noudon siirtymällä eräajoihin perustuvasta JSON-rajapinnasta moderniin HTTPS API -ratkaisuun, joka mahdollistaa hakukriteereihin perustuvan tiedonhaun, selkeämmän rakenteen ja joustavamman käytön eri tarpeisiin.
Nykytila: tuotetietojen nouto JSON-rajapinnan kautta
Toimintaperiaate
Rajapinnan kautta on mahdollista noutaa tuotetietoja GDSN:n tietorakennetta mukailevassa JSON-muodossa.
Haaste
• Tarkoitettu kaikkien tuotetietojen synkronointiin eräajoina
• Ei mahdollista antaa hakukriteereitä tulosten rajaamiseksi
• Nouto tapahtuu kahdessa erillisessä operaatiossa
• Pakkaushierarkian nouto haastavaa
Uusi HTTPS-pohjainen JSON-tuotetietorajapinta
HTTPS JSON API:
• Kaikki tuotetiedot JSON-muodossa Hyödyt
• Mahdollistaa noudettavien tietojen rajaamisen hakukriteereillä
• Ongelmien ratkaisu helpompaa
• Helpottaa ylläpitoa
• Vastaa paremmin erilaisiin käyttötarpeisiin
Alustava ratkaisuehdotus:
Tunnistautuminen API-avaimella, ei erillistä kirjautumista. Kolme erillistä rajapintaa:
/api/sdp/
• Tavarantoimittajan omien tuotetietojen haku ja nouto
/api/rdp/
• Vastaanotettujen tuotetietojen haku ja nouto
• Tuotetietotilausten (kyselyjen) tekeminen
• Kertaluontoisten kyselyjen tekeminen
/api/pp/
• Julkisten tuotetietojen (kauppapaikka) haku ja nouto