VIRTA-opintotietopalvelun tiedot ovat olleet hyödynnettävissä kansallisen palveluväylän kautta elokuusta 2016 alkaen. Kansalliseen palveluväylään toteutetun integraation tavoitteena on ollut avata tietovarantoa laajemmalle käyttäjäkunnalle ja tukea tietojen uudelleenkäyttöä niin julkisissa kuin yksityisissä sähköisissä palveluissa. Ks. lisätietoja.
Huom! Oppijan tietovirtojen ja VIRTA-opintotietopalvelun ohjausryhmän päätöksen (24.10.2018) mukaisesti muiden kuin viranomaistoimijoiden suoria VIRTA-integraatioita ei jatkossa enää kehitetä, vaan ne ohjataan hyödyntämään opetushallituksen ylläpitämää opinto- ja tutkintotietojen luovutuspalvelua (KOSKI-palvelussa). Uudet viranomaistietotarpeet toteutetaan ensisijaisesti opinto- ja tutkintotietojen luovutuspalvelun kautta, ellei viranomaisen tietotarpeesta muuta johdu. CSC ylläpitää VIRTA-opintotietopalvelun liityntää Palveluväylään nykyisten asiakkaiden tarpeisiin.
LIsätietoja
Yhteystiedot:
Hyödyntäminen, sisältö ja lupakäytänteet: virta@csc.fi
Tekninen ylläpito virtakapa@csc.fi
Rajapinnan kuvaus
CSC kehittää ja ylläpitää VIRTA-opintotietopalvelua tietovarannon teknisen ylläpitäjän, opetus- ja kulttuuriministeriön valtuuttamana. Virta opintotietopalvelun tietosisällöstä ja rajapintojen kuvauksista löytyy yksityiskohtaisempaa tietoa palvelun kotisivulta http://www.csc.fi/virta
Opiskelijan tietoja voi hakea, joko kansallisella oppijanumerolla tai henkilötunnuksella. Haun voi rajata joko tiettyyn organisaatioon tai hakea kaikista. Rajapinnan käyttöoikeuksia voidaan rajata organiosaation ja palvelukutsun mukaan. Esimerkiksi jollekin palvelullle voidaan myöntää oikeus ainoastaan Tutkintotietoihin (Kutsu 6) joltakin yksittäiseltä korkeakaoululta.
Web Service: OpiskelijanTiedotService
- LukukausiIlmoittautumiset
- Opintosuoritukset
- OpiskelijanKaikkiTiedot
- OpiskelijanTiedot
- Opiskeluoikeudet
- Tutkinnot
Kaikille kutsuille yhteiset parametrit
- Hakuehdot - extension of type HakuEhdot
- henkilotunnus type HenkilotunnusTyyppi - type string with restriction maxLength(200) pattern((0[1-9]|[12][0-9]|3[01])(0[1-9]|1[0-2])[0-9][0-9][+\-A]((00[2-9]|[0-8][1-9][0-9]|[1-8][0-9][0-9])[0-9ABCDEFHJKLMNPRSTUVWXY])?)
- kansallinenOppijanumero type string
- organisaatio type organisaatio
Rajapinnan kutsut ja vastaukset
Esimerkkikutsu
- LukukausiIlmoittautumisetOperation type:Request-response. The endpoint receives a message, and sends a correlated message.Input:LukukausiIlmoittautumisetRequest (soap:body, use = literal, part = client)LukukausiIlmoittautumisetRequest type LukukausiIlmoittautumisetOutput:LukukausiIlmoittautumisetResponse (soap:body, use = literal, part = client)LukukausiIlmoittautumisetResponse type LukukausiIlmoittautumisetResponse
- OpintosuorituksetOperation type:Request-response. The endpoint receives a message, and sends a correlated message.Input:OpintosuorituksetRequest (soap:body, use = literal, part = client)OpintosuorituksetRequest type OpintosuorituksetOutput:OpintosuorituksetResponse (soap:body, use = literal, part = client)OpintosuorituksetResponse type OpintosuorituksetResponse
- OpiskelijanKaikkiTiedotOperation type:Request-response. The endpoint receives a message, and sends a correlated message.Input:OpiskelijanKaikkiTiedotRequest (soap:body, use = literal, part = client)OpiskelijanKaikkiTiedotRequest type OpiskelijanKaikkiTiedotOutput:OpiskelijanKaikkiTiedotResponse (soap:body, use = literal, part = client)OpiskelijanKaikkiTiedotResponse type OpiskelijanKaikkiTiedotResponse
- OpiskelijanTiedotOperation type:Request-response. The endpoint receives a message, and sends a correlated message.Input:OpiskelijanTiedotRequest (soap:body, use = literal, part = client)OpiskelijanTiedotRequest type OpiskelijanTiedotOutput:OpiskelijanTiedotResponse (soap:body, use = literal, part = client)OpiskelijanTiedotResponse type OpiskelijanTiedotResponse
- OpiskeluoikeudetOperation type:Request-response. The endpoint receives a message, and sends a correlated message.Input:OpiskeluoikeudetRequest (soap:body, use = literal, part = client)OpiskeluoikeudetRequest type OpiskeluoikeudetOutput:OpiskeluoikeudetResponse (soap:body, use = literal, part = client)OpiskeluoikeudetResponse type OpiskeluoikeudetResponse
- TutkinnotOperation type:Request-response. The endpoint receives a message, and sends a correlated message.Input:TutkinnotRequest (soap:body, use = literal, part = client)TutkinnotRequest type TutkinnotOutput:TutkinnotResponse (soap:body, use = literal, part = client)TutkinnotResponse type TutkinnotResponse