Kaikkien PTV-integraation tehneiden organisaatioiden siirryttävä käyttämään uutta rajapintaversio 12:ta viimeistään 2027

Palvelutietovarannossa kehitetään parhaillaan seuraavaa rajapintaversiota numero 12, joka korvaa nyt käytössä olevan version 11. Kaikkien PTV-tietoja OUT-rajapinnan kautta hyödyntävien tai PTV:hen tietoja IN-rajapinnan kautta tuovien organisaatioiden on siirryttävä käyttämään uutta rajapintaversio 12:ta viimeistään keväällä 2027.  

Muutos ei aiheuta toimenpiteitä organisaatioille, jotka tallentavat tiedot PTV:n käyttöliittymään manuaalisesti eivätkä hyödynnä tietoja omissa verkkopalveluissaan.

PTV-integraatiota käyttävien asiakasorganisaatioiden on syytä alkaa

• suunnitella rajapintaversion vaihtoa hyvissä ajoin IT-toimittajan kanssa ja
• varautua muutostöiden kustannuksiin tulevien vuosien budjetoinnissa. 

Uuteen rajapintaversioon siirtyminen aiheuttaa toteuttamisvaiheessa kustannuksia, mutta uusi rajapintaversio on yksinkertaisempi käyttää sekä nopeampi ja vakaampi kuin aiemmat PTV-rajapintaversiot.  

Rajapintaversion vaihtaminen ei vaikuta siihen, miten esim. verkkosivuilla esitetään PTV-tietoja: sivuston rakennetta tai sisältöjä ei tarvitse tämän muutoksen takia uudistaa. 

Uusi rajapintaversio tehdään osana PTV:n arkkitehtuuriuudistusta. Uudistuksessa selkiytetään ja yksinkertaistetaan PTV:n teknistä toteutusta, tehdään rajapinnoista helpommin hyödynnettävät ja toteutetaan runsaasti vuosien varrella asiakkailta tulleita kehitysehdotuksia. Lue lisää arkkitehtuuriuudistuksesta.

Rajapintavaihdoksen alustava aikataulu 

1/2026 

• Uuden rajapintaversion 12 OUT-rajapintametodit julkaistaan. 
• Nykyisen rajapintaversio 11:n OUT- ja IN-rajapinnat ovat yhä käytettävissä. 

06/2026 

• Uuden rajapintaversion 12 IN-rajapintametodit julkaistaan koulutusympäristössä ja niitä pääsee testaamaan. 
• Versio 11:n OUT ja IN-rajapinnat ovat yhä käytettävissä. 

Kevät 2027, täsmentyy vielä

• Uuden rajapintaversion 12 IN-rajapintametodit julkaistaan tuotantoympäristössä.
• Kaikki IN-rajapinnan käyttäjät siirtyvät samaan aikaan versio 12:n käyttäjiksi. 
• Versio 11:n OUT- ja IN-rajapinnat poistuvat kokonaan käytöstä. 

Digi- ja väestötietovirasto tiedottaa rajapinta-asiakkaita aikataulun tarkentumisesta ja muista yksityiskohdista säännöllisesti viesteillä ja Suomi.fi kehittäjille -sivustolla. Syksyllä tarjolle on tulossa dokumentaatiota ja migraatio-ohjeistusta. 

Infotilaisuus  

Tule kuulemaan arkkitehtuuriuudistuksesta ja uudesta rajapintaversiosta infotilaisuuteen pe 9.5. klo 9-10. Tilaisuus järjestetään Teamsilla. 

Ilmoittaudu infotilaisuuteenAvautuu uuteen ikkunaan.

Maaliskuun OUT- tai IN-työpajoihin osallistuneille tiedoksi, että infossa esitellään pitkälti samoja aiheita kuin työpajoissa. 

Kiitokset kyselyyn vastanneille 

Digi- ja väestötietovirasto teki rajapinta-asiakkaille helmikuussa 2025 kyselyn, jossa pyydettiin kommentteja uuteen rajapintaversioon suunnitelluista muutoksista ja aikataulusta. Lisäksi kyselyn yhteydessä oli mahdollisuus ilmoittautua rajapintatyöpajoihin. Maaliskuussa pidetyissä työpajoissa pureuduttiin syvemmin kehitysideoihin ja saatiin asiakkailta arvokkaita näkemyksiä muutostarpeista.  

Kyselyn vastauksista ja työpajoista ilmeni, että suunnitellut muutokset ovat valtaosin tarpeellisia ja toivottuja. Rajapintauudistuksen suunnittelussa ja aikataulutuksessa pyritään huomioimaan vastauksissa esitetyt huolenaiheet. Kiitokset kyselyyn vastanneille ja työpajoihin osallistuneille! 

Lisätietoja osoitteesta ptv-tuki@dvv.fi