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/valtiontalous/v1/budjettitaloudentapahtumat
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.