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