Aika alkaa testata Palvelutietovarannon rajapintaversiota 12 – versio 11 poistuu käytöstä huhtikuussa 2027

Kaikkien Palvelutietovarantoon integraation toteuttaneiden organisaatioiden on siirryttävä käyttämään uutta rajapintaversiota 12 viimeistään huhtikuussa 2027. Palvelutietovarannon rajapintaversio 11 ajetaan tuolloin alas. Muutos koskee sekä hakurajapintaa (OUT) että tuontirajapintaa (IN).

Integraation toteuttaneiden organisaatioiden on syytä alkaa suunnitella siirtymistä uuden rajapintaversion käyttöön. Hakurajapintaa käyttävät voivat jo testata uutta rajapintaversiota.
Hakurajapinta (OUT-rajapinta) on julkaistu betaversiona tuotantoympäristössä, ja rajapinnasta on haettavissa tuotantoympäristön data.

PTV:n API-dokumentaatioAvautuu uuteen ikkunaan.

Ohjeistus rajapintaversion 12 käyttöön löytyy Suomi.fi-kehittäjille sivustolta sivulta Rajapinta- ja arkkitehtuuriuudistus ja sen alasivuilta.

Huomaathan, että nyt julkaistu hakurajapinta on vielä betaversio, johon tulee pieniä rikkovia muutoksia vielä syksyn aikana. Muutoslokia ylläpidetään sivulla V12-hakurajapinnan muutosloki.

Lopullinen versio hakurajapinnasta julkaistaan tuotantoympäristössä vuoden 2026 loppupuolella, kun Digi- ja väestötietovirasto on voinut varmistua siitä, että uutta rajapintaversiota on testannut riittävän moni organisaatio, eikä merkittäviä kehitystarpeita enää tule.

Kerro kommenttisi hakurajapinnasta

Jos havaitset hakurajapintaa testatessasi jotain epäkohtia tai kehitettävää, anna meille palautetta. Ilmoitathan meille kaikista havainnoistasi matalalla kynnyksellä.

Voit antaa kommenttisi hakurajapinnasta osoitteeseen ptv-tuki@dvv.fi.

API-avain käytössä

Rajapinnan käyttö versiossa 12 edellyttää API-avainta. Suosittelemme, että API-avaimia hallinnoi aina PTV-käyttöluvan saanut käyttäjäorganisaatio, ja se jakaa avaimen IT-toimittajansa käyttöön.

Hae API-avainta hallinnointikäyttöliittymässäAvautuu uuteen ikkunaan..

Ohjeet API-avaimen tilaamiseen löydät sivulta API-avaimen käyttöohje.

Tuontirajapinta testattavaksi syksyllä

Tuontirajapinnan (IN-rajapinnan) rajapintametodit julkaistaan testattavaksi asiakastestiympäristössä syksyllä 2026. Lopullinen tuotantoversio tuontirajapinnasta julkaistaan viimeistään alkuvuodesta 2027.