Reittiopas API rajapinnan ohjeet

Helsingin seudun liikenne -kuntayhtymä (HSL) tarjoaa Reittioppaan rajapinnan käyttöoikeutta tuotekehitys- ja testauskäyttöä varten, mikäli kehitettävä ohjelmisto tai palvelu edistää joukkoliikennettä ja matkustajainformaation saatavuutta.Tällä hetkellä on kaksi mahdollista tapaa hakea aikataulu- ja reittitietoja:

• HTTP GET rajapinta, joka palauttaa vastauksen XML-muodossa
• Kalkati.net muotoinen XML data dump -tiedosto, jossa koko aineisto on yhdessä tiedostossa

Tuotekehitys- ja testauskäytössä rajapintojen käyttö on maksutonta. Tuotantokäytössä olevien palveluiden liikenteestä rajapintaan on neuvoteltava erikseen. Dokumentaatio tarjotaan vain englanninkielisenä ja HSL ei vastaa niissä mahdollisesti esiintyvistä virheistä tai niistä muille aiheutuneista vahingoista. Mikäli havaitsette dokumentaatiossa puutteita tai kehityskohteita, kertokaa niistä meille yhteydenottolomakkeella.

Rajapinnan avausta pyydetään hakulomakkeella, tai mikäli tarvitsette lisätietoja, voitte pyytää niitä yhteydenottolomakkeella. HSL varaa oikeuden tarkastaa rajapintaa käyttävien palveluiden toiminta ennen käyttäjäoikeuksien avaamista. HSL:llä on oikeus lopettaa rajapinnan käyttöoikeus tarvittaessa, esimerkiksi tilanteessa jossa käytöstä aiheutuu palvelulle liiallista kuormitusta tai palvelua käytetään väärin.