Palvelulupaus

 


Palvelulupaus on palveluntarjoajan julkinen sitoutuminen kuvatun palvelun tuottamiseen ja toteutuksen sanallistettuun laatuun.


Maritime MaaS API eli rajapinta on toteutettu, jotta vesiliikennöitsijät ja vesiliikenteen lippujen jälleenmyynnistä kiinnostuneet tahot voivat sopia liiketoiminnallisesta yhteistyöstä ja innovoida uutta liiketoimintaa vesiliikenteen ympärille lipunmyyntirajapintaa hyödyntäen.


Maritime MaaS -rajapinta välittää liikennöitsijöiden liikennöintitietoa GTFS-muodossa sekä tarjoaa rajapintaan integroituneille tahoille mahdollisuuden lipputuotteiden jälleenmyyntiin.


Rajapintamme ei välitä maksutapahtumatietoja eikä loppuasiakasta yksilöivää dataa.


Rajapinnan suorituskykyä monitoroidaan automaattisesti, joten tieto rajapinnan teknisestä käyttökatkosta saavuttaa nopeasti sekä rajapinnan teknisestä ylläpidosta vastaavan tahon, että tämän jälkeen sovitun viestintäprosessin mukaisesti myös rajapintaan integroituneet tahot.


Rajapinnan kehittämiseen liittyvistä, ennakoitavista käyttökatkoista informoidaan sovitun viestintäprosessin mukaisesti rajapintaan integroituneita tahoja.


Rajapinnan ylläpitäjä ei vastaa rajapinnan käyttökatkoista rajapintaa hyödyntäville mahdollisesti aiheutuvista välillisistä tai välittömistä kustannuksista (ks. Käyttöehdot).


Rajapinnan ylläpitäjä ei vastaa rajapintaan kohdistuneen ilkivallan tai muutoin sen tahallisen, toisia vahingoittavan virheellisen käytön seurauksista.

Palvelun sisältö

Rajapintatoteutus sisältää seuraavat toiminnallisuudet:

  • Liikennöintitietojen hakeminen

  • Matkan paikkatilanteen hakeminen (mikäli toteutettu lippujärjestelmään)

  • Varauksen tekeminen ja vahvistaminen

  • Varauksen hakeminen

Palvelun tavoite


Rajapinnan toteutuksessa ja jatkokehityksessä pyritään seuraaviin asioihin:

  • yleisiin standardeihin pohjautuvat tai niiden henkeä tarkoituksenmukaisesti noudattavat teknisen toteutuksen ratkaisut

  • teknisen toteutuksen toimintavarmuus

  • teknisen toteutuksen skaalautuvuus

  • teknisten ratkaisujen perustuminen oikeisiin käyttötapauksiin, joiden toteutuksessa pyritään ratkaisuihin, jotka tukevat mahdollisimman monen hyödyntäjätahon tarpeita käyttäjäerityisten ratkaisujen sijasta


Palvelun käyttäjäryhmät

Maritime MaaS -rajapinnan tehtävä on mahdollistaa uuden liiketoiminnan kehittäminen ja innovointi liikennöitsijöille, maas-operaattoreille ja muille vesiliikenteen reittiliikenteen lippujen jälleenmyynnistä ja liiketoiminnallisesta yhteistyöstä kiinnostuneille. Rajapinnan käyttäjäryhmiä ovat mm.:

  • vesiliikenteen operaattorit eli vesiliikennöitsijät

  • vesiliikenteen lipputuotteiden jälleenmyynnistä kiinnostuneet tahot

  • maas-operaattorit

  • vesiliikennettä sisältäviä matkaketjuja ja palvelupaketteja tarjoavat palveluntuottajat

Palvelulupaus

 

Palvelulupaus Maritime MaaS -rajapinnan osalta on seuraava:

  • Käyttövarmuus: rajapinnan teknisestä ylläpidosta huolehditaan siten, että sitä hyödyntävät tahot voivat luottaa rajapinnan toimivuuteen osana liiketoimintaansa

  • Ohjeistuksen ajantasaisuus: rajapinnan käyttöönoton kuvausta ylläpidetään

  • Teknisen dokumentaation ajantasaisuus: rajapinnan tekninen dokumentaatio vastaa aina viimeisintä tuotantoversiota

  • Käyttöönoton tuki: rajapintaan integroituvat saavat halutessaan käyttöönoton tukea, varsinaista teknistä tukea rajapintaan ei tarjota

  • Versionhallinta: rajapinnan kehitystyölle on määritelty teknisen versioinnin mekanismi, joka on kuvattu ja  johon sitoudutaan

  • Jatkokehityksen koordinointi: rajapinnan jatkokehitykselle on määritelty prosessi, prosessi on kuvattu, ja siihen sitoudutaan


Jatkokehityksen osalta sisältöä täydennetään kauden 2022 aikana.



Vesiliikenteen MaaS -hanke - Maritime MaaS project
Marite MaaS API documentation 2021-2022
Forum Virium Helsinki & City of Helsinki