Suomi.fi kehittäjille
Siirry suoraan sisältöön.

Tutustu PTV:n rajapintaversio 12:n ohjeistukseen ja dokumentaatioon ja osallistu klinikoille

UutinenSuomi.fi-palvelutietovaranto

Julkaistu 28.8.2025

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 tulevaa rajapintaversio 12:ta viimeistään keväällä 2027.    

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

Lisää tietoa aiheesta sivulla Rajapinta- ja arkkitehtuuriuudistus.

Ensimmäinen versio ohjeistuksesta tarjolla

Suomi.fi kehittäjille -sivuston Palvelutietovaranto-sivuilla on julkaistu ensimmäinen luonnosversio rajapintamigraation (siirtymän) ohjeistuksesta. Ohjeistus täydentyy vielä syksyn aikana eikä ole vielä kattava.

Tutustu ohjeisiin: Siirtyminen rajapintaversiosta V11versioon V12

Ohjeistus on ensimmäinen julkinen luonnosversio, josta otamme mielellämme vastaan kommentteja. Voit kirjoittaa kommenttisi nimettömänä sivun lopussa olevan palautetoiminnallisuuden avulla. Valitse jokin Oletko tyytyväinen tämän sivun sisältöön -otsikon alla olevista painikkeista ja kirjoita kommenttisi.

Kommentit tulevat DVV:lle ilman yhteystietoja, vaikka sellaiset tekstikenttään kirjoittaisitkin. Emme siis vastaa kommentteihin. 

Ensimmäiset tekniset API-kuvaukset

Samalla kun rajapintaversio 12 otetaan käyttöön, PTV:n rajapintametodien kuvaukset siirtyvät Swaggeristä Scalariin. Muu integraatioiden toteuttamiseen liittyvä dokumentaatio on jatkossakin Kehittäjille-sivustolla. 

Pääset jo tarkastelemaan tulevan rajapintaversion ensimmäisiä API-kuvauksia Scalarin training-ympäristössä.  

Tutustu ensimmäisiin API-kuvauksiin: PTV API SpecificationAvautuu uuteen ikkunaan.

Dokumentaatio julkaistaan Scalarin tuotantoympäristössä myöhemmin. 

Tervetuloa rajapintauudistuksen klinikoille 

DVV järjestää vapaamuotoisia Teams-klinikoita, joissa on mahdollista kysyä ja keskustella rajapintauudistuksesta. Voit tulla klinikalle kysymään jotain asiaa tai pelkästään kuuntelemaan keskustelua. Ilmoittautuminen ei sido sinua mihinkään.  

Klinikoilla on paikalla DVV:n taholta myös kehittäjiä teknisempiin kysymyksiin vastaamassa. 

Ilmoittaudu klinikoille 

Oletko tyytyväinen tämän sivun sisältöön?