Versions Compared

Key

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

...

Info

Lukurajapinta

Tietojen saatavuus

Rahoitushakujen tiedot ovat kaikkien käytettävissä.

Tutkimustoimijat voivat halutessaan ladata muita 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. tällä hetkellä ainoastaan nykyisin TTV:oon 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,
  • rahoituspäätöksistä, ja
  • rahoitushauista

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

Tiedot ovat saatavissa JSON-muodossa rajapinnasta haettuna. Tiedot noudattavat tutkimustietovarannon 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.

Tutkimustietovarannon kuvailutiedot (metatiedot, metadata) jaetaan rajapinnasta lähtökohtaisesti CC0-lisenssillä. Kuvailutiedot ovat vapaasti käytettävissä sekä kaupallisiin että ei-kaupallisiin tarkoituksiin. Mahdolliset poikkeukset ja lisätiedot: https://wiki.eduuni.fi/x/WjrwFg

Kirjoitusrajapinta

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

...