Rajapinnat
Kaikki verkkokauppasovellukset on mahdollista kytkeä suoraan Matkahuollon tietojärjestelmään XML-rajapinnan avulla.
XML-rajapinta on toteutettu yksinkertaisena XML-pyyntönä, johon vastaus tulee XML-muodossa. Pyyntö lähetetään (POST) https-protokollalla yhteysosoitteeseen. Onnistuneen pyynnön vastauksena tulee XML-tiedosto, joka sisältää vastauksen lisäksi osoitekortin pdf-dokumenttina. Pdf tulostetaan ja liitetään lähetykseen.
XML-pyynnön muoto on määrätty, mutta mukana on useita vapaaehtoisia kenttiä. Https-protokolla on ainoa sallittu, palvelin ei hyväksy suojaamatonta http-pyyntöä.
Matkahuollon noutopistehaun rajapintakuvaus
Noutopistehaun rajapintakuvaus
Matkahuollon osoitekorttihaun rajapintakuvaus
Osoitekorttihaun rajapintakuvaus
Esimerkkitiedostot
Käyttöönottoa helpottamaan Matkahuolto tarjoaa esimerkkikoodeja muutamalla yleisimmällä web-ohjelmointikielellä. Esimerkkikoodien käyttö on vapaata ja niitä saa käyttää sekä henkilökohtaisiin että kaupallisiin järjestelmiin. Koodeja voi käyttää sellaisenaan tai muokattuina, mutta omalla vastuulla. Huomioithan myös, että esimerkkikoodien toimintavarmuutta ei ole testattu kaikissa olosuhteissa.
Koodit ovat zip-pakattuja:
Java: matkahuolto java 090826
Ruby: matkahuolto ruby 090826
Testaus ja käyttöönotto
Rajapinnan testausta varten Matkahuollon palvelimilla on testiympäristö, johon lähetetyt pyynnöt palauttavat oikeamuotoisen vastauksen. Testiympäristössä lähetystä ei oteta käsittelyyn. Käyttöönotto tapahtuu helposti yhteysosoitetta vaihtamalla.
Asiakastunnukset ja tekninen tuki
Testausta ja käyttöönottoa varten tarvitset maksuttoman asiakastunnuksen, jonka voit tilata Matkahuollosta sähköpostilla verkkokauppapalvelut@matkahuolto.fi.
Tekninen tuki auttaa käyttöliittymään ja xml-rajapintaan liittyvissä kysymyksissä. Sähköposti tekniseen tukeen on verkkokauppapalvelut@matkahuolto.fi.