Page History

Lukurajapinta

Tietojen saatavuus

Tutkimustoimijat voivat halutessaan ladata tutkimustietovarannon tietoja rajapinnasta. Sen avaamiseksi OKM tarvitsee tiedoksi sekä tietojen käyttötarkoituksen tai käyttötarkoitukset että tutkimustoimijan lakisääteisen tai säätiön säännöissä määrätyn tehtävän, johon tietojen käyttö perustuu.

Tutkimustoimija saa käyttöönsä kaikki tai osan seuraavista tietokokonaisuuksista: julkaisut, tutkimusaineistot, tutkimusinfrastruktuurit, tutkimustoimijat ja rahoituspäätökset. Tutkijan omat tiedot (ns. profiilitiedot ja tutkimusaktiviteetit) saa ladattua, jos tutkija on antanut suostumuksensa niiden luovuttamiseen tutkimustietovarannon rajapinnan kautta. Tutkija antaa suostumuksensa Tutkijan tiedot -työkalussa organisaatiokohtaisesti tiettyyn käyttötarkoitukseen.

Lukurajapinnan ensimmäisen version (29.3.2023) kautta haettavissa ovat tiedot

• julkaisuista (huom
  • Huom. tällä hetkellä ainoastaan nykyisin TTV:lle ladattavat julkaisut, ei kata mm. yhteisjulkaisuiden osajulkaisuja tai hylättyjä julkaisuja
  • Seuraavissa tiedoissa tyhjät tiedot kääntyvät virheellisesti arvolle 0: internationalCollaboration (YhteisjulkaisuKVKytkin), selfArchivedCode (RinnakkaistallennettuKytkin), businessCollaboration (YhteisjulkaisuYritysKytkin). Lataukseen on tulossa korjaus.
• tutkimusaineistoista ja
• rahoituspäätöksistä

Rahoitushakujen tiedot ovat kaikkien käytettävissä.

Rajapintaa kehitetään edelleen ja uusia tietokokonaisuuksia asetetaan tarjolle ensimmäisen version julkaisun jälkeen.

Tiedot ovat saatavissa JSON-muodossa rajapinnasta haettuna. Tiedot noudattavat tutkimutietovarannon tietomallia ja käytössä olevia koodistoja: https://tietomallit.suomi.fi/model/ttv. Tietojen tulkitsemisen tueksi on luotu kattava dokumentaatio: https://research.fi/api/rest/swagger/index.html ja https://wiki.eduuni.fi/x/PA6XE.

Kirjoitusrajapinta

Osalle tietokokonaisuuksista pyritään kehittämään myös kirjoitusrajapinta, jonka avulla tietoja voidaan tuoda tutkimustietovarantoon.