Palvelutietovarannon rajapintaversion 12 hakurajapinta betaversiona tuotantoympäristössä - myös API-avain käyttöön

Palvelutietovarannon uuden rajapintaversion 12 hakurajapinta eli OUT-rajapinta on julkaistu betaversiona tuotantoympäristössä. Rajapinnasta on haettavissa tuotantoympäristön data. 

API-dokumentaatio löytyy jatkossa osoitteesta https://docs.palvelutietovaranto.suomi.fi/api-documentation/v12/Avautuu uuteen ikkunaan.. 

Ohjeistus rajapintaversion 12 käyttöön löytyy sivulta Rajapinta- ja arkkitehtuuriuudistus ja sen alasivuilta. 

Nyt julkaistu rajapinta on betaversio, johon tulee muutoksia vielä pitkään.

Muutoslokia ylläpidetään sivulla V12-hakurajapinnan muutosloki.  

Rajapintahauissa saattaa esiintyä 503 Service unavailable -virhettä. Tämä johtuu hetkellisistä kuormapiikeistä, joita ei vielä ole saatu optimoitua uusiin rajapintoihin. Jos tätä virhettä esiintyy, lähetäthän palautetta osoitteeseen ptv-tuki@dvv.fi, jotta sovelluksen toimintaa saadaan optimoitua. 

Lopullinen versio 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. Lopullisen tuotantoversion julkaisuajankohta kerrotaan syksyllä.  

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

API-avain käyttöön 

Tuotantoympäristön käyttö versiossa 12 edellyttää API-avaimen käyttöä.  

Hae API-avainta hallinnointikäyttöliittymässä osoitteessa https://palvelutietovaranto.suomi.fi/self-service.Avautuu uuteen ikkunaan. 

Ohjeet API-avaimen tilaamiseen löydät sivulta API-avaimen käyttöohje (PTV rajapintaversio 12). 

API-avaimen hallinnointikäyttöliittymä julkaistaan nyt hieman riisuttuna versiona, ja se muuttuu vielä huhti-toukokuun aikana. Nyt aluksi organisaatio voi käytännössä tilata API-avaimen vain yhtä integraatiota varten. Esimerkiksi hyvinvointialueen, jolla on useita PTV-integraatioita, kannattaa testailla rajapinnan 12 betaversiota aluksi vain yhdellä integraatiolla. 

Myöhemmin keväällä tulee mahdollisuus tilata avaimia eri integraatioita varten. Tiedotamme siitä ja tarvittavista toimenpiteistä myöhemmin. 

API-avain tulee käyttöön myös asiakastestiympäristössä huhti-toukokuun aikana eli hieman myöhemmin kuin tuotantoympäristössä.  

Otamme kommentteja vastaan  

Hakurajapinnat julkaistaan nyt betaversiona, ja otamme vastaan palautetta ja huomioita testauksen tuloksista, dokumentaatiosta sekä ohjeistuksesta.  

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