Jotta tieto liikkuisi saumattomasti eri organisaatioiden välillä, tarvitsee Suomi yhtenäisyyttä rajapintakehitykseen. TIEKE vauhditti sidosryhmäyhteistyötä kansallisten API-periaatteiden kehittämishankkeessa vuoden 2021 aikana. Kansallisten rajapintaperiaatteiden määrittely ja toimeenpano oli osa hallitusohjelman Tiedon hyödyntäminen ja avaaminen -hankekokonaisuutta, jonka vastuuministeriö on valtiovarainministeriö.
API-periaatteita tukeva yhteistyö tarjosi konkreettista hyötyä kaikille osapuolille: rajapintaosaaminen vahvistuu, ekosysteemien muodostuminen helpottuu, kehitystyössä ei tarvitse aina keksiä pyörää uudelleen ja datan hyödyntäminen on sujuvampaa.
Hankkeen tuloksena syntyi raportti API-toimintamallin kehittämisestä
Raportin sisällys
- Taustaa
- Kokemukset työpajoista
HAASTE: Puutteellinen ymmärrys APIen tarjoamista mahdollisuuksista
HAASTE: Liiketoimintatarpeen tunnistaminen
HAASTE: Dokumentaatio ja soveltaminen
HAASTE: Organisaatioissa ei ole tiekarttaa rajapintojen käytön edistämiseksi
HAASTE: APIen kehittämisen ja käytön hinta on koettu liian korkeaksi - Verkoston luonti sekä ylläpito, hallinta ja vastuut
- Verkoston toiminnan ja rajapintojen kehittämisen rahoitus
Hanke oli poikkisektorillinen ponnistus
Yhteistyöhön saatiin laaja edustus, joka työsti API-periaatteita siten, että ne palvelisivat sekä kansalaisia, julkisen hallinnon toimijoita että hallinnon kanssa yhteistyötä tekeviä yrityksiä ja yhteisöjä.
Kehittämistyötä tehtiin verkostossa, johon osallistui rajapintakehityksestä kiinnostuneita organisaatioita. Käytännössä toiminta oli työpajoihin osallistumista ja periaatteiden kommentointia.
Tarkoituksenmukaisten API-periaattedein määrittely ja käyttöönotto edellyttää sekä rajapintoja tekevien että niitä toiminnassaan hyödyntävien organisaatioiden osallistumista.
Mikä on ohjelmointirajapinta?
Ohjelmointirajapinta (Application programming interface, API) määrittelee, miten ohjelmisto tarjoaa tietoja tai palveluita sovelluksille tai muille tietojärjestelmille.
- datarajapinta auttaa siirtämän palvelun sisältämän datan toisiin järjestelmiin
- toiminnallinen rajapinta tarjoaa myös myös muita ominaisuuksia, kuten laskenta-algoritmeja
- avoin rajapinta on avoimesti 1) dokumentoitu, 2) käyttöönotettava ja 3) testattavissa
Avointa dataa voidaan hyödyntää esimerkiksi tuotteiden ja palveluiden suunnittelussa, raportoinnissa, markkinoinnissa ja journalismissa, kouluttamisessa ja tiedolla johtamisessa. Soveltamisideat oppaasta Yhdessä kohti avoimen datan liiketoimintaa (Forum Virium, 2017)
Esimerkki datarajapinnasta on kansalaisaloite.fi:n rajapinta, joka kertoo kansalaisaloitteiden tietoja. Esimerkki toiminnallisista rajapinnoista on Helsingin seudun liikenteen reittioppaan rajapinta, joka tarjoaa reititysalgoritmin.
Tekstilähde: avoinrajapinta.fi Kuvalähde: copyright Paper Planes, CC BY-ND 4.0
Viitekehys yhteentoimivuuden puolesta
Kansalliset API-periaatteet koskevat koko julkista hallintoa. Johtotähtinä kehitystyössä ovat olleet eri toimintojen yhdenmukainen saatavuus ja hyödyntäminen sekä uudelleenkäytettävyys. Periaatteet ovat tärkeä lisä yhteentoimivan digitalisaation edistämiseksi Suomessa.
Periaatteita hyödynnetään julkisissa tietojärjestelmähankinnoissa ja rajapintojen kehityksessä. Ne toimivat rajapintakehityksen pitkän aikavälin viitekehyksenä.
Periaatteilla edistetään julkisen hallinnon
- asiakaslähtöisyyttä ja yhteistyötä,
- yhteentoimivuutta ja uudelleenkäytettävyyttä
- laatua
Kansalliset periaatteet palvelevat myös yrityksiä ja muita ei-julkisia toimijoita, koska ne edistävät standardien syntyä ja edistävät näin datan liikkumista ja yhteentoimivuutta. Siksi kehitystyö panosti laajaan yhteiskehittämiseen. Esimerkiksi yritysten on jatkossa helpompaa kehittää, ylläpitää ja hyödyntää julkishallinnon ohjelmointirajapintoja, kun yksityistä sektoria on kuultu jo periaatteita laadittaessa.
Käytännön tavoitteet yhteistyölle vuonna 2021 olivat:
- Erityisesti ohjelmointirajapintoja julkishallinnolle tarjoavat ja toteuttavat sekä julkishallinnon rajapintoja hyödyntävät yritykset työstivät periaatteita ja niiden toimeenpanoa.
- Kansallisten API-periaatteiden kehitystyöhön osallistui laaja kirjo organisaatioita eri sektoreilta.
- Tunnistimme ohjelmointirajapintaperiaatteisiin liittyvät riskit eri rooleissa toimivien organisaatioiden näkökulmasta sekä keinot niiden hallintaan.
- Kartoitimme mitä API-periaatteiden kehitys-, ylläpito- ja hallintatyön hankintaprosessien kehittäminen edellyttää.
- Loimme käytännöt arvioida ohjelmointirajapintoja koskevia periaatteita (myös rajapintakohtaiset yhteiset periaatteeet) ja niiden käytettävyyttä säännöllisesti.
- TIEKE toteutti sidosryhmäyhteistyön vauhdittamista kansallisten API-periaatteiden kehittämishankkeessa
- Periaatteiden laatiminen oli osa hallitusohjelman Tiedon hyödyntäminen ja avaaminen -hanketta, jonka vastuuministeriö on valtiovarainministeriö.
- TIEKEn vastuulla yhteistyössä oli sidosryhmäyhteistyön tukeminen ja eri sektoreiden organisaatioiden sitouttaminen rajapintaperiaatteiden kehitystyöhön.
- Lisätietoa yhteistyöstä
Timo Simell | TIEKE
timo.simell[at]tieke.fi
Miina Arajärvi | valtiovarainministeriö
miina.arajärvi[at]vm.fi - Avoin data ja rajapinnat -esitesarja Forum Viriumin verkkosivuilla
