Julkisen hallinnon API-periaatteet ja verkostoyhteistyö

Johdanto

Ohjelmointirajapinnat (englanniksi Application Programming Interface, API) ovat dokumentoituja rajapintoja, joiden avulla ohjelmistot, sovellukset tai järjestelmät voivat vaihtaa keskenään tietoa tai toiminnallisuuksia.

Julkisten hallinnon API-periaatteiden tarkoituksena on edistää julkisen hallinnon tietojen ja toimintojen tarjoamista sekä hyödyntämistä ohjelmointirajapintojen avulla. Kun uusia ratkaisuja voidaan kehittää jo olemassa olevien tietojen, toimintojen ja ohjelmointirajapintojen päälle, päällekkäinen työ ja päällekkäiset ratkaisut vähenevät, kehittämistyö nopeutuu ja tuottavuus kasvaa. 

Periaatteiden tavoitteena on lisätä semanttista ja teknistä yhteentoimivuutta, uudelleenkäytettävyyttä, tietoturvan ja tietosuojan huomioimista sekä laatua ohjelmointirajapintojen kehityksessä. Periaatteita tuetaan verkostoyhteistyöllä.

Julkisen hallinnon API-periaatteet ovat saatavilla suomeksi, ruotsiksi ja englanniksi. Periaatteet on kehitetty valtiovarainministeriön Tiedon hyödyntämisen ja avaamisen hankkeessa.


Rajapintaperiaatteita on kaksitoista

Strategisen tason periaatteet organisaation johdolle

  Strategiset periaatteet
1.1 Tarjoa ja hyödynnä tietoja pääsääntöisesti ohjelmointirajapintojen kautta
1.2 Määritä ohjelmointirajapintojen tarjoamiselle ja hyödyntämiselle tavoitteet ja hanki riittävät resurssit
1.3 Varmista hankinnoissa yhteentoimivuus muiden tietojärjestelmien kanssa
1.4 Edistä sisäistä ja ulkoista yhteistyötä

 
Taktisen tason periaatteet organisaation tiedonhallintaa kehittäville toimijoille

  Taktiset periaatteet
2.1 Kehitä ohjelmointirajapintoja tarvelähtöisesti
2.2 Määritä ohjelmointirajapintojen tarjoamiseen ja hyödyntämiseen liittyvät roolit, tehtävät, vastuut ja toimintamallit
2.3 Kuvaa ohjelmointirajapintojen muodostama kokonaisuus
2.4 Tunnista ja hallitse ohjelmointirajapintoihin liittyvät riskit

 
Operatiivisen tason periaatteet ohjelmointirajapintoja kehittäville ja ylläpitäville toimijoille

  Operatiiviset periaatteet
3.1 Kehitä ohjelmointirajapinnat avoimilla ja teknologiariippumattomilla standardeilla ja protokollilla
3.2 Kuvaa ohjelmointirajapintojen käsittelemät tiedot yhteisten ja yleisten tietomallien mukaisesti
3.3 Testaa, versioi, dokumentoi ja julkaise ohjelmointirajapinnat
3.4 Seuraa ohjelmointirajapinnoille asetettuja mittareita ja muita ominaisuuksia