Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Julkisten palvelujen luokitus: https://koodistot.suomi.fi/codescheme;registryCode=ptv;schemeCode=ptvserclass2

Palvelukokonaisuudet

Palvelukokonaisuus on Suomi.fi-palvelutietovarannossa hallinnoitava vapaavalintainen kokoelma palveluita. Suosittelujen tuloksia voidaan rajata käyttäen rajauksena haluttua palvelukokonaisuutta tai -kokonaisuuksia. Tällöin palvelukokonaisuus muodostaa eräänlaisen whitelistin, josta varsinainen suosittelu (3x10d tai vapaateksti) tehdään. Tämä mahdollistaa suosittelun tuloksien tiukemman rajaamisen palvelukohtaisesti. 

Kokonaisuuksia hallinnoidaan Palvelutietovarannossa, jonne tunnukset haetaan Suomi.fi-palveluhallinnasta. Palvelukokonaisuudet eivät muuta alkuperäisiä palvelukuvauksia ja ne voivat sisältää vapaasti eri organisaatioiden palveluja. 

Rajapintakutsussa palvelukokonaisuutta käytetään vastaavasti kuin muitakin rajauskenttiä. Niitä voidaan myös tarpeen mukaan yhdistää muihin rajauksiin. Esimerkkikutsussa (alla) tekstihaku on rajattu koskemaan tiettyä palvelukokonaisuutta ja lisäksi on sallittu kansalliset palvelut.

Code Block
{
  "search_text": "nuorten työttömyys",
  "service_filters": {
    "include_national_services": true,
    "service_collections": [
      "16f7b099-3ab2-49c8-a646-9b029de85f20"
    ]
  },
  "limit": 5
}