Ohjelmointirajapinnat ovat keskeinen osa digihankkeita
Hyvin suunnitellut ohjelmointirajapinnat eli API:t tukevat digitaalisten palvelujen kehittämistä ja niiden tehokasta käyttöönottoa.
Julkisen hallinnon digitalisaatiohankkeet ovat usein laajoja ja monimutkaisia. Ohjelmointirajapinnat
tarjoavat keinon hallita hankkeiden teknistä infrastruktuuria
mahdollistavat paremman tiedonkulun organisaatioiden välillä.
Julkisen hallinnon tietotekniikka hyödyntää yhä enemmän pilvipalveluita. Pilvipalvelut tarjoavat joustavan alustan modernien teknologioiden, kuten tekoälyn, hyödyntämiseen. Ohjelmointirajapintojen kautta toimivat tekoälyratkaisut voivat tehostaa ja automatisoida prosesseja.
Päivitetty: 5.5.2026
Miten hyödyn oppaasta?
Oppaan luettuasi
osaat suunnitella yhteentoimivia tietojärjestelmiä, jotka vaihtavat tietoja sujuvasti, vähentävät päällekkäistä työtä ja parantavat palveluiden laatua
osaat hyödyntää ohjelmointirajapintoja tiedon ja ohjelmistojen uudelleenkäytön tukena
osaat suunnitella ja toteuttaa hankintoja API-lähtöisesti ja tuotteistaa ne tehostamaan ja sujuvoittamaan prosesseja
ymmärrät ohjelmistoarkkitehtuurin kehitystä ja ohjelmointirajapintojen kasvavaa merkitystä pilvipalveluissa ja ekosysteemeissä.
Oppaan hyvät käytännöt pohjautuvat Digi- ja väestötietoviraston (DVV) fasilitoiman julkisen hallinnon API-verkoston työhön. Oppaan ovat kirjoittaneet Digi- ja väestötietoviraston johtava asiantuntija Mika Honkanen ja Kamoon Digital Oy:n strategiakonsultti Petri Aukia.
Opas tarjoaa käytännönläheisiä hyviä käytäntöjä API-suunnittelun eri vaiheisiin ja ohjaa lukijan lisätiedon lähteille. Tavoitteena on varmistaa, että ohjelmointirajapintojen suunnittelu tukee julkisen sektorin digitalisaation tavoitteita ja tuottavuuden parantamista.
Tämän oppaan kirjoittajat haluavat kiittää kaikkia raportin sisällöntuotantoon osallistuneita henkilöitä antamastaan avusta. Erityisesti kiitämme seuraavia asiantuntijoita, jotka ovat auttaneet raportin laadinnassa tai olleet haastateltavana raporttia varten:
Anssi Lepistö, pääarkkitehti, DigiFinland Oy
Arto Kvist, kehityspäällikkö, DigiFinland Oy
Ida Rainio, Principal Designer, Futurice Oy, Helsingin kaupungin Dataekosysteemien viitekehys -hankkeen konsultti
Janne Järvinen, Digitalization Mission Lead, Business Finland
Janne Peltola, toiminnanjohtaja, Open Knowledge Finland ry
Jari Isokallio, johtava asiantuntija, Digi- ja väestötietovirasto
Jenni Väisänen, projektipäällikkö, Verohallinto
Jenny Vuollet, johtaja, kehittäminen ja kokeilut, DigiFinland Oy
Juha Karvonen, Partner Solution Architect, Microsoft Oyj
Juha Mykkänen, johtava asiantuntija, Terveyden ja hyvinvoinnin laitos
Kimmo Koivu, hallituksen jäsen, Software Finland Ry
Lauri Soro, tekninen projektipäällikkö, Gofore, Yrityksen digitalous-projekti
Markus Lindqvist, (näkemykset eivät ole Amazon Web Servicen virallisia näkemyksiä)
Miika Antila, API-arkkitehti, Verohallinto
Mika Ahvenainen, kehityspäällikkö, Fintraffic
Mika Hyyrynen, ICT-asiantuntija, API-tiimin vetäjä, Verohallinto
Mika Leivo, johtava data-arkkitehti, Helsingin Kaupunki
Mikko Pitkänen, johtaja, Digitalisaation tukipalvelut ja yhteentoimivuus, DVV
Minna Rintala, hankejohtaja, Yrityksen digitalous –hanke, Patentti- ja Rekisterihallitus
Olli Ahonen, apulaisjohtaja, tietojohtamisen palvelut, Valtiokonttori
Olli Pitkänen, lakiasiainjohtaja, 1000 Lakes Oy
Robin Gustafsson, strategisen johtamisen professori, Aalto-yliopisto
Roosa Lampinen, erityisasiantuntija, Digi- ja väestötietovirasto
Suvi Nuttunen, erityisasiantuntija, Digi- ja väestötietovirasto
Tapio Tiili, johtava arkkitehti, Reaktor Oyj
Tiina Silvonen, tietotekniikka-asiantuntija, Helsingin Yliopisto
Tommi Gynther, Senior Consultant, CGI Oyj
Ville Peltola, päällikkö, Tekoäly ja data, Teknologiateollisuus
Ville Rinne, pääarkkitehti, Google cloud (näkemykset eivät ole Google Cloudin virallisia näkemyksiä)
Lisäksi haluamme kiittää Digi- ja väestötietoviraston koordinoimaa julkisen hallinnon API-verkostoa kommenteista ja tuesta työn aikana sekä valtiovarainministeriötä ”Julkisen hallinnon API-periaatteet”-raportista, joka auttoi jäsentämään työtä viitekehyksenä.
Mayers, B. A. & Stylos, J. 2016. Improving API usability. Communications of the ACM 9(6), ss. 62-69.
MobilityData. 2024. GTFS: Making Public Transit Data Universally Accessible. WWW-dokumentti. Saatavissa: https://gtfs.org/Avautuu uuteen ikkunaan.. Viitattu 11.4.2024.
Thayer, K. & Chasins, S. E. & Ko, A. J. 2021. A Theory of Robust API Knowledge. ACM Transactions on Computing Education. Vol 21(1). ss. 1-32. PDF-dokumenttti. Saatavissa: https://dl.acm.org/doi/10.1145/3444945Avautuu uuteen ikkunaan.. Viitattu 26.3.2024.
Yarygina, T. & Bagge, A. H. 2018. Overcoming Security Challenges in Microservice Architectures. 2018 IEEE Symposium on Service-Oriented System Engineering (SOSE). ss. 11-20. Saatavissa: https://doi.org/10.1109/SOSE.2018.00011Avautuu uuteen ikkunaan.. Viitattu 24.2.2024.
Päivitetty: 8.5.2026
Esimerkkejä API-suunnittelun hyvistä käytännöistä
Oppaan hyvien käytäntöjen havainnollistamisen tueksi on tuotettu esimerkkejä, jotka löytyvät alta liittenä:
