Keskeiset parannukset ja muutokset

Uuteen rajapintaan (versio 12) toteutetaan seuraavat ominaisuudet:  

Sisältöjen järjestäminen

• Teemme mahdolliseksi sisältöjen, esim. asiointikanavien järjestämisen.

Rajapintojen nimityksiä muutetaan

Viestinnän selkiyttämiseksi OUT-rajapinta on jatkossa hakurajapinta ja IN-rajapinta tuontirajapinta.

API-avain  

• Otamme käyttöön API-avaimen hakurajapinnassa (nykyinen OUT-rajapinta). 
• Käyttäjä saa API-avaimen, kun on antanut tiedot integraatiosta ja yhteystiedot viestintää varten.   

 Pakollisuuksien muutokset  

• Toimintaohje muuttuu pakolliseksi 3.3.2026 käyttöliittymässä ja keväällä 2027 tuontirajapinnassa (nykyisin IN-rajapinta). 
• Muutamme pakolliseksi toimialatiedon antamisen (joko tietty toimiala tai toimialariippumaton), jos palvelun kohderyhmänä on Yritykset ja yhteisöt.
• Teemme www-osoitteiden ja sähköpostiosoitteiden nimikentissä nimen antamisesta pakollista, mikäli www-osoite on annettu. Näin linkit voidaan esittää PTV-dataa hyödyntävässä päässä saavutettavasti.  

Päivämäärät ja aukioloajat  

• Muutamme rajapinnan päivämääräformaatin standardimuotoiseksi ja otamme käyttöön ISO 8601-standardin.  
• Lisäämme aukioloaikatiedolle vapaatekstikentän, jossa voi antaa lisätietoa aukioloajasta, esim. "suljettu kesän ajan". 
• Helpotamme ja yksinkertaistamme palveluaikojen syöttämistä käyttöliittymässä. Uusi hakurajapinta palauttaa palveluajat uuden mallin mukaisesti. 
• Yhdenmukaistamme käyttöliittymän ja tuontirajapinnan (nykyinen IN-rajapinta) aukiolotyypit, nyt niissä on eroja.  

Luokittelutietojen muutokset  

• Otamme käyttöön uuden toimialaluokituksen. 
• Annamme pohjakuvauksille uudet, tarkemmat pohjakuvaustyypit, jotka helpottavat pohjakuvausten hyödyntämistä. Uudet pohjakuvaustyypit: Kuntien palvelut, Hyvinvointialueiden palvelut, Työllisyysalueiden palvelut, Evankelis-luterilaisen kirkon palvelut, Muut palvelut  

Tekstien muotoilut ja sisältöjen järjestäminen  

• Uudistamme väliotsikkojen ja listojen toteutuksen nykystandardien mukaiseksi. Muotoillut tekstikentät noudattavat jatkossa Markdown-syntaksia. Rajoitukset: kuvia ja hyperlinkkejä ei voi lisätä.
• Nostamme tekstikenttien maksimimerkkimääriä. Esimerkiksi kuvauskentän merkkimäärä muuttuu 2500:sta 5000 merkkiin. 
• Uudessa rajapinnassa kieliversioidut tiedot palautuvat omassa kokoelmassaan, ei kuten nykyisin tietue kerrallaan kieliversioittain. 
• Teemme mahdolliseksi palveluiden ja asiointikanavien järjestämisen käyttöliittymässä ja rajapinnassa.  

External id  

• Tuomme hakurajapintaan mahdollisuuden hakea sisältöjä ulkoisen järjestelmän tunnisteella (external id, aiemmin source id)  

Aluetiedon muutokset  

• Poistamme käytöstä aluetiedon automaattisen periytymisen palvelulta asiointikanavalle.  
• Migraatiossa annamme niille sisällöille, joilta puuttuu aluetieto, aluetiedon Organisaation tiedoissa olevan Alue, jolla organisaatio pääsääntöisesti tuottaa palvelua -tiedon perusteella.  

Esteettömyystiedot  

• Rajapintaversion 12 hakurajapinta ei enää palauta esteettömyyslausekkeita. Tiedot voi jatkossa hakea suoraan Helsingin kaupungin esteettömyyssovelluksen rajapinnasta. 
• Jatkossa tuontirajapinnasta (IN-rajapinta) voi luoda linkin esteettömyyssovellukseen, jolloin PTV:n käyttöliittymän käyttö ei ole enää pakollista tuontirajapinnan käyttäjille. 

Palvelupaikan koordinaatit

• Rajapinta palauttaa jatkossa palvelupaikan koordinaattien lisäksi tiedon, mikäli koordinaatti on käyttäjän muokkaama.​

Dokumentaatio ja virheviestit   

• Varmistamme, että jatkossa rajapinta ja skeema sekä muu rajapintadokumentaatio vastaavat toisiaan ja että muutosten tekeminen on koordinoitua. 
• Huolehdimme, että haku- ja tuontirajapinnan toiminnallisuudet ja virheviestit vastaavat jatkossa toisiaan ja virheviestit toteutetaan ymmärrettävämmässä muodossa.