Suomi.fi kehittäjille
Siirry suoraan sisältöön.
Hyvät käytännöt kehittäjille
Ohjelmointirajapintojen suunnittelu julkisessa hallinnossa

Tue kokeiluja ja hyödyntämistä

Tarjoa kokeilemiseen testausohjelmointirajapinta

Ohjelmointirajapintojen käyttöönotto suoraan tuotantoympäristössä on usein riskialtista ja haastavaa. Siksi on tärkeää tarjota avoin testiversio, joka helpottaa käyttöönottoa.

Päivitetty: 5.5.2026

Käytä testi-APIssa anonymisoitua dataa

Monet ohjelmointirajapinnat käsittelevät henkilötietoja, ja tietosuojan vuoksi pääsy näihin tietoihin on rajattava tarkasti. Henkilötietoja käsittelevän ohjelmointirajapinnan kehittäminen ja testaaminen on siis haastavampaa.

Henkilötietoja käsittelevien ohjelmointirajapintojen rinnalla tulisi tarjota erillinen testi-API, joka käyttää synteettistä tai anonymisoitua dataa. Synteettinen data on keinotekoisesti luotua, mutta tilastollisesti todellista dataa muistuttavaa.

Päivitetty: 5.5.2026

Julkaise avoin tietoaineisto

Tiedon julkaiseminen tiedostona auttaa sen hyödyntämisessä. Kun data jaetaan tiedostona (esimerkiksi CSV- tai Excel-muodossa), sen kokeilu ja testaus on helppoa ja nopeaa.

Jos data osoittautuu hyödylliseksi, sitä voidaan myöhemmin hakea ja käyttää ohjelmointirajapinnan avulla. Tämä on erityisen tärkeää avoimen datan yhteydessä, kuten julkisen sektorin hallussa olevissa tiedoissa, joista on hyötyä laajalle yleisölle.

Avoimesta datasta ja julkisen sektorin hallussa olevien tietojen uudelleenkäytöstä laaditussa direktiivissä kannustetaan myös tiedostona julkaisemiseen ja listataan korkean lisäarvon tietoaineistot.

Tutustu EU:n direktiiviin avoimesta datasta ja julkisen sektorin hallussa olevien tietojen uudelleenkäytöstä (EUR-Lex).Avautuu uuteen ikkunaan.

Päivitetty: 5.5.2026

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

Sanasto