Siirry sivun sisältöön

Terveyskylän tietämyskannan tekninen toteutus ja integrointi

Terveyskylän tietämyskanta on joustava ja uudelleenkäytettävä. Sen tekninen toteutus mahdollistaa sisällön monikanavaisen hyödyntämisen eri alustoissa ja käyttötarkoituksissa.

Terveyskylän tietämyskanta on suunniteltu hyödynnettäväksi monipuolisesti erilaisissa digitaalisissa palveluissa. Sen perusajatus on, että sisältö on rakenteista ja irrotettu yksittäisestä verkkosivun esitystavasta. Tämä tarkoittaa, että sisältöä ei ole sidottu tiettyyn sivupohjaan, käyttöliittymään tai julkaisutapaan.

Rakenteinen sisältö mahdollistaa sen, että samaa tietoa voidaan käyttää useissa eri käyttöliittymissä ja palveluissa samanaikaisesti. Sama sisältö voi palvella esimerkiksi verkkosivuja, asiointiportaaleja ja asiakaspalvelun ratkaisuja ilman, että sitä tarvitsee tuottaa tai ylläpitää erikseen jokaiseen ympäristöön.

Tietämyskannan tekninen ratkaisu tukee pitkäjänteistä kehittämistä ja palvelujen kehittymistä ajan myötä. Kun sisältö ja sen rakenne ovat erillään käyttöliittymästä, digipalveluja voidaan uudistaa, laajentaa tai korvata ilman, että itse sisältöä tarvitsee rakentaa uudelleen. Tämä tukee sekä kustannustehokkuutta että hallittua kehitystä.

Terveyskylän tietämyskanta muodostaa yhteisen ja joustavan perustan, jonka päälle hyvinvointialueet ja muut toimijat voivat rakentaa omia digitaalisia ratkaisujaan. Yksityiskohtaisempi tekninen toteutus, rajapintojen käyttö ja kehittäjille tarjottava dokumentaatio on kuvattu tarkemmin tämän sivun seuraavissa osioissa.

Kiinnostuitko tietämyskannan hyödyntämisestä?

Ota yhteyttä ja keskustellaan teidän käyttötarpeistanne, yhteydenotot tuki(at)terveyskyla.fi.

Tieto haetaan helposti Terveyskylän tarjoaman REST-rajapinnan kautta. Rajapinta mahdollistaa tietämyskannan sisällön hyödyntämisen joustavasti erilaisissa digitaalisissa palveluissa ilman, että sisältöä tarvitsee kopioida tai ylläpitää erikseen useissa järjestelmissä.

Rajapinnan kautta voidaan hyödyntää muun muassa kielivalintaa siten, että sisältöä voidaan tarjota suomeksi, ruotsiksi ja osin englanniksi. Sisällöt ovat selkeästi rakenteistettuja ja perustuvat moderniin, modulaariseen tietomalliin, mikä tukee niiden käyttöä eri käyttötarkoituksissa ja käyttöliittymissä.

Tekninen ratkaisu on suunniteltu siten, että sama sisältö voidaan hyödyntää useissa palvelukokonaisuuksissa samanaikaisesti. Tämä tukee hallittua kehittämistä, vähentää päällekkäistä työtä ja mahdollistaa digipalvelujen kehittämisen vaiheittain ilman riippuvuutta yksittäisestä käyttöliittymästä. Rajapinnan käyttö edellyttää sopimusta Terveyskylän kanssa.

Terveyskylä tarjoaa kehittäjille suunnatun API-portaalin, joka tukee rajapinnan sujuvaa ja hallittua käyttöönottoa. API-portaali kokoaa rajapintojen käytön kannalta olennaisen tiedon yhteen paikkaan ja auttaa kehittäjiä hahmottamaan kokonaisuutta ilman tarvetta erillisille selvitystöille.

API-portaali sisältää rajapintojen dokumentaation sekä työkalut rajapintakutsujen testaamiseen. Dokumentaatio kuvaa käytettävissä olevat rajapinnat, tietorakenteet ja perusperiaatteet siten, että kehittäjä pystyy suunnittelemaan toteutuksen hallitusti omassa ympäristössään.

Tulevaisuudessa API-portaalia kehitetään edelleen niin, että se tukee myös rajapintojen käyttöön liittyvää analytiikkaa sekä yhteisöllisiä toimintoja, kuten kehittäjien välistä tiedonjakoa. Näiden avulla rajapinnan käyttöä ja kehittämistä voidaan tukea pitkäjänteisesti ja läpinäkyvästi.

Tietämyskannan sisällöt tunnistetaan yksilöllisten artikkelitunnisteiden avulla. Nämä tunnisteet mahdollistavat yksittäisten sisältöjen kohdentamisen, hakemisen ja hyödyntämisen rajapinnan kautta hallitulla tavalla.

Artikkelitunnisteiden avulla hyvinvointialue voi määritellä, missä digipalveluissa sisällöt näytetään ja/tai mihin palvelukokonaisuuteen ne kuuluvat. Tämä tukee sisällön uudelleenkäyttöä ja mahdollistaa sen, että samaa tietoa voidaan hyödyntää eri konteksteissa ilman manuaalista työtä.

Tietämyskannan sisältöjä hyödynnetään rajapintojen kautta osana hyvinvointialueiden digitaalisia palveluja ja palveluketjuja. Rajapinnan käyttö edellyttää aina sopimusta Terveyskylän kanssa.

Sopimukselliset periaatteet varmistavat, että tietämyskannan sisältöjä käytetään hallitusti, tarkoituksenmukaisesti ja yhteisiä pelisääntöjä noudattaen. Tämä tukee sisällön luotettavuutta, ylläpidettävyyttä ja pitkäjänteistä kehittämistä koko verkoston näkökulmasta. Sopimisen kautta varmistetaan, että käyttöönotto tapahtuu sujuvasti ja osapuolet ymmärtävät tietämyskannan käyttämiseen liittyvät vastuut ja roolit.

Tekninen valmius rajapintojen hyödyntämiseen on olemassa, ja rajapintoja käytetään jo osana Terveyskylän eri palvelukokonaisuuksia.

Tarkistettu 4.6.2026