Rajapinnat ja koneluettavat aineistokuvailut
Tietoarkisto tarjoaa useita rajapintoja, joiden kautta aineistojen metatiedot ovat saatavilla eri tarkoituksiin. Julkisten rajapintojen hyödyntämiseksi vaadittavaa dokumentaatiota on koottu osoitteeseen https://gitlab.tuni.fi/fsd/documentation-for-public-apis (Avautuu uuteen välilehteen) . Alla on esitetty lyhyesti keskeiset saatavilla olevat rajapinnat.
Aineistokuvailut DDI-C 2.5 -formaatissa
Tietoarkiston tuottamat aineistokuvailut ovat saatavilla DDI-C 2.5 -formaatissa (Avautuu uuteen välilehteen) koneluettavina XML-tiedostoina. DDI-muotoiset kuvailut sisältävät samat tiedot kuin Aila-palveluportaalin aineistoluettelon kuvailut.
Linkki kunkin aineiston DDI-muotoiseen kuvailuun on Ailassa aina aineiston kuvailusivun lopussa. Linkkien muoto suomen- ja englanninkielisille kuvauksille on esitetty alla. <AINEISTONUMERO> on Tietoarkiston aineistolle antama identifikaatiotunnus, esimerkiksi FSD2653.
| kieli | linkin muoto |
|---|---|
| suomi | https://services.fsd.tuni.fi/catalogue/<AINEISTONUMERO>/DDI/<AINEISTONUMERO>_fin.xml |
| englanti | https://services.fsd.tuni.fi/catalogue/<AINEISTONUMERO>/DDI/<AINEISTONUMERO>_eng.xml |
Kaikista aineistoista ei ole saatavilla kuvailuja molemmilla kieliversioilla. Aineistot, joiden muuttujat on kuvailtu vain ruotsiksi, julkaistaan Ailan suomenkielisessä luettelossa ruotsinkielisinä. Kieliversiot eivät myöskään välttämättä ole keskenään tietosisällöltään samanlaisia. Eroja on lähinnä muuttujakuvauksien kattavuudessa.
Latauksen helpottamiseksi DDI-kuvailuista on koostettu zip-paketti:
Paketit päivitetään aina, kun aineistoluettelo päivittyy. Luettelossa ei yleensä tapahdu kovin suuria muutoksia yhden päivän aikana. DDI-kuvailutietoja hyödyntävän tietokoneohjelmiston kannattaa hakea tiedot esimerkiksi kerran viikossa.
Linkit zip-pakettien sisältämiin kuvailuihin on koottu tekstitiedostoihin, jotka päivittyvät samaan aikaan zip-pakettien kanssa:
- linkit suomenkielisiin kuvailuihin (Avautuu uuteen välilehteen) TXT
- linkit englanninkielisiin kuvailuihin (Avautuu uuteen välilehteen) TXT
OAI-PMH-rajapinta Kuha
Kuha2
Tietoarkiston aineistokuvailut ovat koneellisesti haravoitavissa DDI Codebook, OAI Dublin Core ja EAD3 -formaateissa Kuha2-rajapinnan (Avautuu uuteen välilehteen) kautta. Kuha2 tarjoaa aineistojen yleiskuvauksen lisäksi muuttujatason metatiedot kieliversioineen. EAD- ja DC-formaatit generoidaan Tietoarkiston DDI-muotoisista kuvailuista. Rajapinnan toteuttava ohjelmisto syntyi osana CESSDA SaW-projektia ja kehitystä jatketaan avoimen lähdekoodin lisenssillä.
Lisätietoja Kuha2:n dokumentaatiosta (Avautuu uuteen välilehteen) .
Kuha1 on suljettu 28.10.2021. Siirry käyttämään monipuolisempaa Kuha2-rajapintaa.
CESSDA Data Catalogue -rajapinta
CESSDA Data Catalog tarjoaa myös OAI-PMH-yhteensopivan rajapinnan, jonka kautta voi haravoida aineistoluettelon koko sisällön. Tietueiden tunnisteet ovat yhdenmukaisia käyttöliittymässä käytettyijen tunnisteiden kanssa. Rajapinta on osoitteessa https://datacatalogue.cessda.eu/oai-pmh/v0/oai (Avautuu uuteen välilehteen) .
FSD SKG-IF API
FSD SKG-IF API on Tietoarkiston julkinen rajapinta, joka noudattaa Scientific Knowledge Graph Interoperability Frameworkia (SKG-IF). Se tarjoaa standardoidun, OpenAPI-pohjaisen pääsyn Tietoarkistoon tallennettujen tutkimusaineistojen metatietoon ja yhdenmukaistaa tutkimusinformaation kuvaustapoja eri tieteenaloilla. Rajapinta on ensisijaisesti suunniteltu koneiden väliseen tiedonsiirtoon, mutta sitä voivat käyttää myös ihmiset.
Lisätietoja: https://api.fsd.tuni.fi/skg-if (Avautuu uuteen välilehteen) .
Käyttöehdot
Aineistokuvailut kaikissa formaateissa
Soveltuvan lainsäädännön sallimassa enimmäislaajuudessa Yhteiskuntatieteellinen tietoarkisto on luopunut kaikista tekijänoikeuslainsäädännön alaisista oikeuksistaan laatimiinsa FSD:n aineistokuvailuihin (FSD metadata records), lähioikeudet ja kaikki tekijänoikeuteen liittyvät oikeudet mukaan lukien.
Tietoarkiston tuottamia aineistokuvailuja voi siis käyttää vapaasti, eikä niiden käytöstä tarvitse erikseen ilmoittaa tai käyttöön hakea lupaa kaupalliseenkaan tarkoitukseen. Käytettäessä kuvailuja tutkimuksessa, opinnäytetöissä tai verkkopalveluissa, on hyvän tieteellisen käytännön mukaista viitata alkuperäiseen tekijään ja lähteeseen ja mainita CC0-lisenssi.