Vipunen API
Koneluettavan rajapinnan avulla voit hyödyntää Vipusen tietosisältöjä myös palvelun ulkopuolella.

Vipusen tilastotietoja on saatavissa käyttöön myös koneluettavassa muodossa REST/JSON-rajapinnan kautta. Koneluettava rajapinta mahdollistaa Vipusen tietosisällön hyödyntämisen esimerkiksi

  • Osana sovelluskehitystä
  • Erilaisissa analysointityökaluissa
  • Organisaatioiden omissa tietovarastoissa​

​Rajapintapalvelu on avattu ​elokuussa 2017 ja sitä kehitetään rajapinnan käyttäjien kokemusten ja havaintojen perusteella. Alkuvaiheessa tietosisältö painottuu opetus- ja kulttuuriministeriön korkeakouluilta keräämiin tietoihin. Tietosisältöä laajennetaan myöhemmin. ​Osaa Vipusen tietosisällöstä ei voida tietosuojasyistä tarjota käytettäväksi koneluettavassa muodossa.

Rajapinnan tietojoukot


​Rajapinnan dokumentaatio

http://api.vipunen.fi/api/

Lista saatavilla olevista tietojoukoista

http://api.vipunen.fi/api/resources

​Tietojoukon kuvaus

http://api.vipunen.fi/api/resources/{tietojoukonnimi}

Esim. http://api.vipunen.fi/api/resources/koulutusluokitus

​Tietojoukon tietosisältö

http://api.vipunen.fi/api/resources/{tietojoukonnimi}/data

Esim. http://api.vipunen.fi/api/resources/koulutusluokitus​/data

Käyttöesimerkit

Esimerkkejä tietojoukon lukemisesta koneellisesti. Lisäksi Ohjeistus-sivulta löytyy esittelyvideoita Vipunen API:n käytöstä.

Huom! Jos sort-toimintoa käyttää ketjutetuissa hauissa, tulee järjestysehtoihin sisällyttää tietojoukon oletusjärjestys kuten suodattamista koskevassa Python-esimerkissä.

Python-esimerkit

Tietojoukon lukeminen

Tietojoukon lukeminen valituilla muuttujilla
Tietojoukon lukeminen suodattamalla tilastovuoden mukaan

R-esimerkit

​Viittausohje

Vipunen – opetushallinnon tilastopalvelu: tietojoukon nimi. Tietolähde. Ladattu pvm.

Esim. Vipunen - opetushallinnon tilastopalvelu: suorittanut55. VIRTA-opintotietopalvelu. Ladattu 21.2.2020.