Rajapinta- ja arkkitehtuuriuudistus

Digi- ja väestötietovirasto on uudistamassa PTV:n arkkitehtuuria. 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.

Uudistuksessa ei muuteta PTV-tietomallia muutamia lisäkenttiä lukuun ottamatta.

Arkkitehtuuriuudistukseen liittyvien infotilaisuuksien tallenteetAvautuu uuteen ikkunaan.

Kaikkien integraation toteuttaneiden organisaatioiden on siirryttävä käyttämään rajapintaversiota 12 viimeistään huhtikuussa 2027. Tämä vaatii organisaatioilta toimenpiteitä.

Aikataulu

01/2026

• Uuden rajapintaversion 12 OUT-rajapintametodit on julkaistu asiakastestiympäristössä (koulutusympäristö) ja niitä pääsee testaamaan.
• Käytettävissä on asiakastestiympäristön nykyinen data, ja olemassa oleviin organisaatioihin voi luoda lisää sisältöjä.​
• Rajapinnoista on haettavissa kaikki eri sisältötyypit, esim. palvelu + asiointikanavat -kokonaisuuden muodostaminen mahdollista. ​
• Versio 11:n OUT ja IN-rajapinnat ovat yhä käytettävissä.

03-04/2026

• Uuden rajapintaversion 12 OUT-rajapintametodit on julkaistu tuotantoympäristössä betana. Tämän jälkeenkin tuotantoon voi vielä tulla muutoksia ennen syksyä 2026.
• Haettavissa on tuotannon data, API-key käytössä.
• Versio 11:n OUT ja IN-rajapinnat ovat yhä käytettävissä.

Syksy 2026 / Täsmentyy vielä

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

Syksy 2026 / Täsmentyy vielä

• Uuden rajapintaversion 12 OUT-rajapintametodien lopulliset versiot julkaistaan tuotantoympäristössä, eikä niihin enää tule rikkovia muutoksia.
• 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.

Huhtikuu 2027 / Täsmentyy vielä

• V11 rajapinnat (OUT ja IN) poistuvat kokonaan käytöstä huhtikuussa 2027.
• Käyttöliittymä siirtyy käyttämään uuden sovelluksen ui-rajapintoja.

Tarkennamme työn etenemisen aikataulua tälle sivulle.

Rajapintaversioon 12 suunnitellut uudet ominaisuudet

Keskeiset parannukset ja muutokset