Siirry suoraan sisältöön.
Hyvät käytännöt kehittäjille
Ohjelmointirajapintojen suunnittelu julkisessa hallinnossa
  1. Oppaan aloitussivu
  2. Ennen hankintaa
  3. Kehittämisen aikana
    1. Rakenna ketterästi
    2. Etsi tai luo avoin tietomalli
    3. Suunnittele ohjelmointirajapinnan rakenne
    4. Valitse ohjelmointirajapintatyyli
      1. Web API:en kasvanut merkitys
      2. Eri ohjelmointirajapintatyylejä
    5. Hallitse prosesseja kohderyhmäajattelun avulla
    6. Rakenna ohjelmointirajapinnan testaus
    7. Huomioi tietosuoja, tietoturva ja pääsyoikeudet
  4. Ohjelman tai sovelluksen valmistuttua
  5. Sanasto

Valitse ohjelmointirajapintatyyli

Web API:en kasvanut merkitys

Internetissä toimivien ohjelmointirajapintojen (Web API) merkitys modernien selain- ja mobiilisovellusten kehityksessä on kasvanut koko 2000-luvun ajan. Tulevaisuudessa ohjelmointirajapintoja tarvitaan yhä enemmän, esimerkiksi tekoälyn ja puheella toimivien käyttöliittymien tueksi.

Modernit internetpohjaiset sovellukset mahdollistavat monipuolisemmat käyttöliittymät, pienemmät tiedonsiirtomäärät ja vähemmän kuormitusta palvelimille verrattuna perinteisiin staattisiin sivuihin. Tällaisia sovelluksia toteutetaan esimerkiksi suosituilla ohjelmistokehityskehyksillä kuten React, Vue tai Angular.

Internetiin kytkettyjen laitteiden määrä kasvaa jatkuvasti, ja erilaisten päätelaitteiden, ohjelmien ja sovellusten määrä lisääntyy. Esimerkiksi moderni vaaka, televisio, auto, jääkaappi ja mikroaaltouuni voivat hakea ja lähettää tietoa ohjelmointirajapintojen avulla. Tämä on lisännyt internetiä tietoliikennekanavana hyödyntävien ohjelmointirajapintojen merkitystä ja määrää.

Päivitetty: 6.5.2026

Eri ohjelmointirajapintatyylejä

Ohjelmointirajapintoja voidaan toteuttaa eri tavoin, ja eri toteutustapoja voi myös yhdistellä. Esimerkiksi RESTful-ohjelmointirajapintojen päälle voidaan rakentaa GraphQL, mikä helpottaa ja tehostaa niiden käyttöä tietyissä tilanteissa.

Kuusi yleisintä ohjelmointirajapintojen toteutustyyliä

REST

Roy Fieldingin vuonna 2000 esittelemä ohjelmistoarkkitehtuurityyli, joka on yleisin tiedonsiirtotapa tietojärjestelmien backendin ja frontendin välillä. REST perustuu viiteen pakolliseen ja yhteen valinnaiseen periaatteeseen.

GraphQL

Avoin standardi, jonka Facebook (nykyisin Meta) kehitti vuonna 2012 ja julkaisi avoimena lähdekoodina vuonna 2015. Se käyttää kyselypohjaista kieltä tietojen hakemiseen.

Websocket

Protokolla, joka mahdollistaa kaksisuuntaisen TCP-yhteyden (Transmission Control Protocol) asiakkaan ja palvelimen välillä. Sitä käytetään erityisesti tilanteissa, joissa palvelin voi lähettää reaaliaikaisia päivityksiä asiakkaalle.

Webhook

Asiakas määrittää palvelimelle yksilöllisen URL-osoitteen ja tapahtumat, joita hän haluaa vastaanottaa. Palvelin lähettää automaattisesti tietoa, kun jokin ennalta määritelty tapahtuma tapahtuu.

gRPC

Google julkaisi gRPC (Remote Procedure Call) avoimena lähdekoodina vuonna 2016. Se on suunniteltu palvelimien väliseen tiedonsiirtoon hajautetuissa tietojärjestelmissä ja perustuu HTTP/2-protokollaan, muistuttaen 1980-luvulla kehitettyä RPC:ä.

SOAP

Viestintäprotokolla, joka esiteltiin vuonna 1999. SOAP (Simple Object Access Protocol) käyttää XML:ää usein organisaatioiden sisäisten tietojärjestelmien välisessä viestinnässä. Sen käyttöä pidetään monimutkaisena, ja sen rajoitusten vuoksi REST on suurelta osin korvannut sen.

Päivitetty: 6.5.2026

Oletko tyytyväinen tämän sivun sisältöön?

Sanasto