Rajapinnat on toteutettu ns. REST rajapintoina ja niissä käytetään JSON-kuvausta tietojen esittämiseen. Merkistökoodauksena käytetään UTF-8:ia.
Useimmissa objekteissa on kenttä "id" jonka arvo toimii objektin sisäisenä tunnisteena jota voi käyttää eperusteiden sisäisten viittausten selvittämiseen.
{
"id" : 611,
"nimi" : { "_id" : "552122", "fi" : "Audiovisuaalisen viestinnän perustutkinto", "sv" : "Grundexamen i audiovisuell kommunikation" },...
}
id:llä tunnistetaan objektin tietty julkaistu versio ja se objektin tyypistä riippuen voi esiintyä myös rajapinnassa (esim. https://virkailija.opintopolku.fi/eperusteet-service/api/perusteet/611 ). Esim. perusteen tapauksessa tunniste ei ole pysyvä kahva tutkinnon perusteen uusimpaan versioon eikä sitä pidä käyttää viitteenä jos perusteeseen viitataan ulkoisesta järjestelmästä.
Sisäiset viittaukset toisiin objekteihin on esitetty seuraavasti. Viittauksen arvona on kohdeobjektin tunniste (id). Huom! Arvo on merkkijono vaikka varsinaisen kohdeobjektin tunniste olisi tyypiltään luku.
?
|
AIkaleimat esitetään pääsääntöisesti millisekunteina alkaen 1970-01-01 00:00:00 UTC (ns. unix-timestamp millisekunteina).
?
|
|
Tekstit ovat pääsääntöisesti objekteja joissa sama sisältö voi olla tarjolla yhdellä tai useammalla kielellä. Tekstiobjekteissa esiintyy kenttä "_id" joka muuttuu jos tekstin sisältö muuttuu.
Tekstisisällöt voivat olla ns. rikasta tekstiä jossa käytetään rajoitettua HTML-merkkausta. Sallitut merkkauselementit ovat:
p, strong ,em, s, ol, li, ul, blockquote, hr, pre, th, thead, a, abbr, table, caption, tbody, tr, td, th, thead, a, abbr
Edellä olevat vahvennetut elementit ovat tuettuja lähes kaikissa teksteissä. Taulukoita voi esiintyä lähinnä laajoissa tekstikappaleissa (perusteen sisältö -osuus). Taulukoita lukuun ottamatta elementeissä ei voi olla attribuutteja (esim. tyylimäärityksiä tms.).
kenttä | tietotyyppi | kuvaus |
---|---|---|
kenttä | tietotyyppi | kuvaus |
id | luku | tunniste |
nimi | teksti | perusteen nimi |
koulutustyyppi | <koodisto-uri> | Koulutustyyppi; https://virkailija.opintopolku.fi/koodisto-service/rest/codeelement/{kentän arvo} |
koulutukset | [koulutus] | (vain ammatillisissa perusteissa). Tutkinnot jotka peruste määrittelee. |
kielet | [merkkijono] | Kielet joilla perusteen sisältö on olemassa. |
kuvaus | teksti | Perusteen tiivistelmä (ei ole osa varsinaista perustetekstiä) |
diaarinumero | merkkijono | Määräyksen diaarinumero |
voimassaoloAlkaa | aikaleima | Perusteen voimassaolon alku (voimassaoloAlkaa < voimassaoloLoppuu <= siirtymaPaattyy) |
voimassaoloLoppuu | aikaleima | Perusteen voimassaolon loppu (voi olla tyhjä jos peruste on toistaiseksi voimassa) |
siirtymaPaattyy | aikaleima | Perusteen siirtymäajan loppu (tyhjä jos peruste on toistaiseksi voimassa. Voi olla sama kuin voimassaoloLoppuu jos perusteella ei ole siirtymäaikaa. |
muokattu | aikaleima | perusteen viimeisin muokkaushetki |
tila | merkkijono | "valmis" jos kyseessä on julkaistu peruste |
tyyppi | - | - |
korvattavatDiaarinumerot | [merkkijono] | lista määräysten diaarinumeroita jotka tämä peruste korvaa. Voi viitata myös perusteeseen jota ei löydy järjestelmästä. |
osaamisalat | [osaamisala] | (vain ammatillisissa perusteissa) Tutkinnon osaamisalat |
tutkintonimikkeet | [tutkintonimike] | (vain ammitillisissa perusteissa) Tutkinnon nimikkeet osaamisaloittain |
suoritustavat | [suoritustapa] | (vain ammatillisissa perusteissa) Tutkinnon suoritustavat (näyttötutkinto ja/tai opetussuunnitelmaperusteinen) |
tutkinnonosat | [tutkinnonosa] | (vain ammatillisissa perusteissa) |
koulutuksenOsat | [koulutuksenosa] | (vain tutkintoon valmistavissa perusteissa) |
perusopetus | [perusopetusSisalto] | (vain perusopetuksen perusteissa) |
lukiokoulutus | [lukiokoulutusSisalto] | (vain lukiokoulutuksen perusteissa) |
lops2019 | [lukiokoulutus2019Sisalto] | (vain 2019 rakenteen mukaisissa lukiokoulutuksen perusteissA) |
esiopetus | [esiopetusSisalto] | (vain esiopetuksen perusteissa) |
aipe | [aikuistenPerusopetusSisalto] | (vain aikuisten perusopetuksen perusteissa) |
tpo | [taiteenPerusopetusSisalto] | (vain taiteen perusopetuksen perusteissa) |
vapaasivistystyo | [vapaasivistystyoSisalto] | (vain vapaan sivistystyön perusteissa) |
tutkintoonvalmentava | [tutkintoonvalmentavaSisalto] | (vain tutkintoon valmentavan perusteissa) |
opas | [opasSisalto] | (vain oppaissa) |
-> Ammatillisen tutkinnon perusteen tiedot
-> Perusopetuksen perusteen tiedot
Swagger-dokumentaatio rajapinnasta: http://opetushallitus.github.io/eperusteet/api/eperusteet
https://eperusteet.opintopolku.fi/eperusteet-service/api/external/perusteet
https://eperusteet.opintopolku.fi/eperusteet-service/api/external/peruste/{perusteId}
esimerkiksi lukion peruste https://virkailija.testiopintopolku.fi/eperusteet-service/api/external/peruste/6828810 sisältää rakenteessaan lops2019 jonka sisältö löytyy oppiaineet
"lops2019" : { "oppiaineet" : [ { "id" : 6828950, "nimi" : { "_id" : "6901378", "_tunniste" : "068ce193-4281-484d-8242-89c09d049750", "fi" : "Äidinkieli ja kirjallisuus", "sv" : "Modersmål och litteratur" }, ... }, ... ] } |
lisäämällä rajapintaan /lops2019/oppiaineet: https://virkailija.testiopintopolku.fi/eperusteet-service/api/external/peruste/6828810/lops2019/oppiaineet saadaan listattua pelkästään kaikki oppiaineet
[ { "id" : 6828950, "nimi" : { "_id" : "6901378", "_tunniste" : "068ce193-4281-484d-8242-89c09d049750", "fi" : "Äidinkieli ja kirjallisuus", "sv" : "Modersmål och litteratur" }, ... }, ... ] |
lisäämällä rajapintaan tietueen id:n saadaan listattua yksittäisiä elementtejä /lops2019/oppiaineet/: https://virkailija.testiopintopolku.fi/eperusteet-service/api/external/peruste/6828810/lops2019/oppiaineet/6828950 saadaan listattua pelkästään kaikki oppiaineet
{ "id" : 6828950, "nimi" : { "_id" : "6901378", "_tunniste" : "068ce193-4281-484d-8242-89c09d049750", "fi" : "Äidinkieli ja kirjallisuus", "sv" : "Modersmål och litteratur" ... }, |
Huom! Alla olevaa rajapintakuvausta ei enää suositella julkisien tietojen hakuun.
Swagger-dokumentaatio rajapinnasta: https://eperusteet.opintopolku.fi/eperusteet-service/
Edellä kuvattu tietosisältö vastaa 'kaikki' rajapinnan palauttamaa tietoa. Muista rajapinnoissa palautettu tieto on suppeampaa.
Perusteiden haku ( https://eperusteet.opintopolku.fi/eperusteet-service/api/perusteet/ )
Rajapinta on sivutettu; oletuksena palautetaan 25 tulosta
sivukokoa voi kontrolloida parametrilla "sivukoko" (maksimi on 100 tulosta)
sivun voi valita parametrilla "sivu" (ensimmäinen sivu on "0")?
|
Esimerkki: perusopetuksen perusteen kaikkien tietojen haku
Julkaistut perusteet voivat muuttua kahdella tapaa.