Muutoksia avoindata.tutkihallintoa.fi-rajapintapalvelussa

Tutkihallintoa.fi-palvelun rajapintapalvelu avoindata.tutkihallintoa.fi muuttuu. Tutkihallintoa.fi-sivuston API-palvelu siirretään uuteen portaaliin, josta löytyy jatkossa kootusti kaikki Valtiokonttorin ylläpitämät avoimet rajapinnat. Palvelun kautta saa tietoa mm. valtion talouteen, henkilöstöön ja toimintaan sekä kuntatalouteen liittyen. Muutokset tulevat voimaan torstaina 7.4.2022, jonka johdosta rajapintapalvelussa on huoltokatko 7.4.2022 klo 9.00–15.00. Rajapintapalvelun osoite avoindata.tutkihallintoa.fi säilyy ennallaan, mutta uudistus aiheuttaa joitain muutoksia rajapintojen käyttöön. Nämä asiat muuttuvat:

APIen versiointi

Jatkossa kaikki rajapintapalvelussa julkaistavat APIt versioidaan rikkovien muutosten osalta. Tarjoamme versiokohtaisen siirtymäajan asiakkaille, jolloin vanha versio on käytettävissä uuden lisäksi siirtymäajan ajan.

Versioinnin myötä APIen kutsuosoitteeseen lisätään versionumero. Samalla kutsuosoitteet kirjoitetaan jatkossa vain pienin kirjaimin.

Uudet kutsuosoitteet

Esimerkiksi kutsuosoite
https://api.tutkihallintoa.fi/talous/BudjettitaloudenTapahtumat
muuttuu muotoon
https://api.tutkihallintoa.fi/talous/v1/budjettitalousvuosikuukausi.

Muutoksia Valtion talous-APIin

Valtion talous-APIsta poistuvat seuraavat rajapinnat (kyseiset rajapinnat siirtyvät uuteen Tilikartta-APIin.):

  • Liikekirjanpitotilit
  • Tililajit
  • Tililuokat
  • Tiliryhmat
  • Ylatiliryhmat

Yhteyskanavat APIen tietosisältöä koskien

Jokainen API sisältää jatkossa yhteysosoitteen, johon voi esittää tarkemmat kysymykset koskien tietosisältöä.

Dokumentaation parannus

APIen dokumentaatiota on tarkennettu erityisesti APIen palauttamiin tietoihin liittyen.