PTV:n integraatioasiakkaat pitävät suunnitelmia rajapinnan uudistamiseksi hyvinä

Digi- ja väestötietovirasto selvitti helmikuussa 2025 toteutetulla, PTV-integraatioasiakkaille suunnatulla kyselyllä, miten asiakkaat hyödyntävät PTV-dataa ja miten he suhtautuvat rajapinnan uudistamissuunnitelmiin, joissa rajapintaan tulee isoja muutoksia.

Kyselyyn vastasi 57 henkilöä, joista 50 oli integraation toteuttaneen tai sitä suunnittelevan asiakasorganisaation ja 7 IT-toimittajan edustajia. Vastaajat hyödyntävät PTV-dataa mm. organisaatioiden verkkosivuilla ja karttapalvelussa, asiointiportaalissa, alueellisilla palvelutarjottimilla, organisaatioiden Google-profiileissa ja asiakaspalvelun taustajärjestelmässä. Datan hyödyntämistä suunniteltiin myös mm. telepalvelujärjestelmässä, Power BI-raporteilla ja kokonaisarkkitehtuurijärjestelmässä.

20 vastaajaa koki, että tietojen hakemiseen nykyisestä rajapinnasta liittyy ongelmia. Tietojen hakemiseen koettiin usein liittyvän virhetilanteita ja hitautta. Myös rajapinnan toteutuksen sekä dokumentaation välillä koettiin olevan ristiriitaisuuksia. Lisäksi mm. muuttuneiden tietojen sekä kuvaustekstien muotoilujen hakemista pidettiin hankalana.

Kyselyssä listattiin uudistuksen toteutettavaksi suunnitellut asiat:

• OUT-rajapintaan toteutetaan API-key.
• Varmistetaan, että jatkossa rajapinta ja skeema sekä muu rajapintadokumentaatio vastaavat toisiaan.
• Uudessa rajapinnassa kieliversioidut tiedot palautuvat omassa kokoelmassaan, ei tietue kerrallaan kieliversioittain, kuten nykyisin.
• Mahdollistetaan palveluiden ja asiointikanavien järjestäminen käyttöliittymässä ja rajapinnassa.
• Muutetaan rajapinnan päivämääräformaatti standardimuotoiseksi.
  
  14 vastaajaa kommentoi uudistuksen sisältöjä tarkemmin. 12 heistä piti suunnitelmia hyvinä. Kaksi vastaajaa suhtautui kriittisesti API-keyhin ja toivoi, että se toteutetaan mahdollisimman kevyesti. Tämä on myös suunnitelmissa.
  
  Kyselystä saatiin myös yksityiskohtaisempaa tietoa yksittäisten toiminnallisuuksien merkityksestä ja prioriteettijärjestyksestä. Kyselyn teemoja syvennettiin kolmessa maaliskuun aikana pidetyssä työpajassa. Teemoista hankitaan lisätietoa myös huhtikuun 2025 aikana tehtävissä asiakasorganisaatioiden haastatteluissa, joihin saattoi ilmoittautua mukaan osana kyselyä.
  
  Lisätietoa PTV:n arkkitehtuuriuudistuksesta