Palvelutietovarannon version 12 hakurajapinnan testaus nyt mahdollista asiakastestiympäristössä

Palvelutietovarannon uuden rajapintaversion 12 hakurajapintaa (OUT-rajapintaa) voi nyt testata asiakastestiympäristön avulla. Version 12 hakurajapinta on julkaistu kokeiltavaksi asiakastestiympäristössä. (Entisen koulutusympäristön nimi muuttuu viikolla 5 asiakastestiympäristöksi.)

Hakurajapinnan metodit ScalarissaAvautuu uuteen ikkunaan.   

Alkuvaiheessa asiakastestiympäristössä testaamiseen ei tarvita API-avainta. API-avain otetaan käyttöön myöhemmin keväällä 2026, ja ilmoitamme siitä erikseen. 

Version 12 IN-rajapinnan testaaminen ei ole mahdollista, vaan IN-rajapinnan metodit julkaistaan asiakastestiympäristöön vasta syksyllä.  

Asiakastestiympäristöön voi luoda sisältöjä 

Version 12 hakurajapintaa voi testata asiakastestiympäristön käyttöliittymään syötetyillä tiedoilla. Testaamista varten organisaatio tai IT-toimittaja voi luoda asiakastestiympäristöön haluamalleen valmiille testiorganisaatiolle palveluita ja asiointikanavia ja liittää niitä toisiinsa. Kannattaa ottaa huomioon, että tiedot siirtyvät asiakastestiympäristöstä rajapintaversioon 12 noin tunnin viiveellä, eivätkä tiedot heti näy version 12 rajapinnassa.  

Asiakastestiympäristön käyttöliittymäAvautuu uuteen ikkunaan.  

Tunnukset asiakastestiympäristön käyttöliittymään löytyvät sivulla https://kehittajille.suomi.fi/palvelut/palvelutietovaranto/ptv-tietojen-hyodyntaminen/tekninen-dokumentaatio-integraation-toteuttajalle/lisatietoa-in-integraation-toteuttajalle#asiakastestiymparisto-ja-rajapinta-testaukseen olevasta excel-taulukosta. Taulukosta voi valita minkä tahansa organisaation ja kirjautua asiakastestiympäristöön sen tunnuksilla. 

Ohjeistusta tarjolla – otamme kommentteja vastaan 

Materiaalia testaamisen tueksi löytyy Suomi.fi kehittäjille -sivustolta sivulta Rajapinta- ja arkkitehtuuriuudistus - PTV: Palvelut yhdenmukaisesti kuvattuina - Suomi.fi kehittäjille ja sen alasivuilta.  

• Hakurajapinnan (OUT-rajapinnan) muutokset versiosta 11 versioon 12  
• Tietomallin yleiskuvaus 
• Käsittelysäännöt rajapintatiedon tulkintaan 

Ohjeistus on vielä luonnosvaiheessa, ja se täydentyy vuoden 2026 aikana.  

Hakurajapinnat julkaistaan nyt testattavaksi, ja otamme vastaan palautetta ja huomioita testauksen tuloksista sekä ohjeistuksesta. Uutta hakurajapintaa testaavat kevään aikana myös muutamat pilottiorganisaatiot, jotka raportoivat havainnoistaan Digi- ja väestötietovirastolle.  

Voit antaa kommenttisi ohjeistuksesta ja uusista hakurajapinnoista osoitteeseen ptv-tuki@dvv.fi.  

Keväällä on tulossa myös rajapintauudistuksen klinikoita, joissa voit esittää huomioitasi ja kysymyksiäsi. Klinikoiden ajankohdat löytyvät Tapahtumat-sivultaAvautuu uuteen ikkunaan..  

Seuraa rajapintauudistuksen viestintää 

Tuotantoympäristöön uuden rajapintaversion 12 hakurajapinnat (OUT-rajapinnat) tulevat tarjolle beta-versiona maalis-huhtikuussa. Version 12 hakurajapinnat julkaistaan tuotantoon lopullisessa muodossa syksyllä 2026, eikä niihin enää sen jälkeen tule rikkovia muutoksia. Tiedotamme julkaisuajankohdasta vuoden mittaan sähköpostitse sekä Suomi.fi kehittäjille -sivustolla. 

Viestimme rajapintauudistuksesta sähköpostitse 

• kaikkien PTV:n käyttöönottaneiden organisaatioiden pääkäyttäjille, riippumatta siitä, onko niillä tällä hetkellä integraatiota vai ei 
• tiedossamme olevien integraation toteuttaneiden organisaatioiden pääkäyttäjille ja meille ilmoitetuille IT-toimittajien edustajille.