Julkaisukanavatietokannan rajapinnan versio 2 on toteutettu aiemmista (v.1) versioista poikkeavalla rakenteella. Versio 2 sisältää myös aiempaa toteutusta kattavammin tietoja, kuten julkaisukanavan lisenssitiedot, kattavammat oa-tiedot sekä tiedon tulevasta tasoluokasta. Näytettävistä tiedoista on poistettu vanhentuneet tiedot.
Muutokset
- 2026 → Taso 0 poistuu käytöstä. Jatkossa entiset 0-tason kanavat kuuluvat ryhmään "Muut tunnistetut julkaisukanavat". Tämä ei vaikuta rajapinnasta tulevaan tietoon, mutta rajapinnan käyttäjien tulisi huomioida muutos rajapintaa hyödyntävissä järjestelmissä.
Tulossa: Merkittävä muutos Level-kentän arvoihin. Osana rajapinnan tasotietojen yhtenäistämistä nykyisen mallin mukaiseksi, vuodesta 2026 lähtien arvioitujen kanavien Level kentän arvo on null, 1 tai 2. Rajapinnan hyödyntäjien on hyvä tarkastaa varsinkin null arvon käsittely. Muutos vaikuttaa myös jufo_history kenttään, eli vuodesta 2026 alkaen kentän tasotieto on null, 1 tai 2.- 12.1.2026 - v2.1 - Muutettu 0 tasot null arvoiksi.
- 14.11.2025 - Lisätty v2.1 - ISBN kenttä merkkijonon sijaan taulukkona.
- 31.10.2025 - Korjattu ISBN kentän tietojen näkyvyyteen liittyvä bugi
- 2.10.2025 - sivuttaminen ja max_modified ja min_modified kentät. Name kentän hakutyyppi muutettu "match" → "match_phrase_prefix".
- 5.5.2025 - level_history string → dict
Kanavan tietojen haku
GET /v2.0/channel/<JUFO_ID>
Palauttaa HTTP statuskoodin 404 mikäli JUFO_ID:tä ei löydy.
Esimerkkihaku
https://jufo-rest.csc.fi/v2.0/channel/63759
Kanavahaku
GET /v2.0/search
Hakuparametrit:
| parametri | kuvaus | hakutyyppi |
|---|---|---|
| name | Kanavan nimi | Hakusanat järjestyksessä. Viimeinen hakusana käsitellään prefiksinä. Esim. "dev" → development, developing "html pag" → html page, html pagination |
| isbn | prefix | |
| issn | match | |
| abbr | Konferenssin lyhenne | |
| type | Mahdolliset arvot:
| |
| max_modified | Maksimi muokkapäivämäärä (yyyy-MM-dd) | |
| min_modified | Minimi muokkauspäivämäärä (yyyy-MM-dd) | |
| _size | Palautettavien tulosten määrä. Maksimi 100. | |
| _from | Ensimmäisen tulosdokumentin indeksi (alkaa nollasta) |
Esim:
GET /v2.0/search?title=Computer&_size=10
Esimerkkihaku
https://jufo-rest.csc.fi/v2.0/search?title=Computer&_size=10
Kanavan tiedot
Kaikki kentät palautetaan jokaiselta kanavalta. Jos kanavalla ei ole tiettyä arvoa, palautuu rajapinnasta joko arvo "null" and tyhjä lista ([]).
identified_object tietotyyppi
Tätä tietotyyppiä käytetään kun kentän arvolla on yleinen tunniste ja mahdollisesti lokalisoidut käännökset. Esimerkkinä maa- ja kielitiedot. identified_object tietotyypin rakenne on aina seuraava:
{
"id": "julkinen tunniste",
"localized_labels": {
"en": "label in English",
"fi": "nimi suomeksi",
"sv": "på svenska"
}
}
| kenttä | tietotyyppi | kuvaus | esimerkki |
|---|---|---|---|
abbreviation | str | konferenssin nimen lyhenne | GRAPP |
| continued_by | int | JufoID julkaisukanavalle, joka toimii tämän julkaisukanavan jatkajana | 50023 |
| continues | int | JufoID julkaisukanavalle, jonka toimintaa tämä julkaisukanava jatkaa | 50232 |
| country | identified object | julkaisumaa | "country": { |
| created | str | päivämäärä, jolloin julkaisukanava on lisätty Julkaisufoorumiin. | "2024-11-01 14:58:33" |
| external | object | Julkaisukanavan tiedot ulkoisista tietolähteistä. | |
| external.index_info | [str] | tietokannat, joihin julkaisukanava on indeksoitu. | "index_info": [ "ERIH+", "Scopus", "Open policy finder" ] |
| external.license | object | Lisenssitietoja. "unknown" arvo tarkoittaa, että tietoa ei ole saatavilla. | "license": {
"channel": "unknown",
"self_archived_accepted": "CC BY NC SA",
"self_archived_published": "CC BY NC SA"
} |
| external.license.sa_accepted | str | lisenssi käsikirjoituksen hyväksytyn version rinnakkaistallentamiselle | |
| external.license.sa_published | str | lisenssi käsikirjoituksen julkaistun version rinnakkaistallentamiselle | |
| external.license.channel | str | julkaisukanavan lisenssi | |
| oa_info | object | Avoimeen julkaisemiseen littyviä tietoja. | "oa_info": {
"has_apc": "yes",
"immediate_sa_allowed_accepted": "no",
"immediate_sa_allowed_published": "no",
"is_diamondOA": false,
"is_finelib": true,
"is_general": false,
"is_hybrid": true,
"is_oa": false,
"is_sa": false,
"open_access_type": "Hybrid"
} |
| oa_info.has_apc | str | julkaisukanava perii APC-maksun avoimesta julkaisemisesta, mahdolliset arvot: yes/no/unknown | |
| oa_info.immediate_sa_allowed_accepted | str | julkaisukanava sallii käsikirjoituksen hyväksytyn version välittömän rinnakkaistallennuksen, mahdolliset arvot: yes/no/unknown | |
| oa_info.immediate_sa_allowed_published | str | julkaisukanava sallii käsikirjoituksen julkaistun version välittömän rinnakkaistallennuksen, mahdolliset arvot: yes/no/unknown | |
| oa_info.is_diamondOA | bool | julkaisukanava on maksuttomasti avoin (diamond open access) | |
| oa_info.is_finelib | bool | julkaisukanava kuuluu FinELib-konsortion avoimen julkaisemisen sopimusten piiriin, mahdolliset arvot: yes/no | |
| oa_info.is_hybrid | bool | julkaisukanava on osittain avoin (hybrid open access) | |
| oa_info.is_oa | bool | julkaisukanava on välittömästi avoin (gold open access) | |
| oa_info.is_sa | bool | julkaisukanava sallii käsikirjoitusten hyväksyttyjen tai julkaistujen versioiden välittömän rinnakkaistallennuksen,. | |
| oa_info.open_access_type | str | julkaisukanavan avoimen saatavuuden tyyppi, mahdolliset arvot: Open access/Hybrid/unknown | |
| oa_info.other_disciplines | object | julkaisukanavan tieteenalaluokitus ulkoisissa lähteissä. | "other_disciplines": {
"norway": [
"Business and Fice"
]
} |
| oa_info.volume | int | julkaisuvolyymi. Minimiarvo 25. | |
| is_active | bool | ||
| is_general | bool | julkaisukanava on yleistajuinen | |
| is_professional | bool | julkaisukanava on ammatillinen | |
| is_scientific | bool | julkaisukanava on tieteellinen | |
| isbn | v2.0 - str v2.1 - list(str) | v2.0
v2.1
| v2.0: "978-81-322;978-3-540;978-3-642;" v2.1: ["978-81-322", "978-3-540", "978-3-642"] |
issn_print | str | julkaisukanavan painetun version ISSN-tunnus | |
| issn_electronic | str | julkaisukanavan elektronisen version ISSN-tunnus | |
| issnl | str | julkaisukanavan ISSNL-tunnus | |
| jufo_id | int | julkaisukanavan yksilöivä tunnus Julkaisufoorumissa | |
language_iso639_2 | identified object | julkaisukielen ISO-639-2 tiedot. | "language_iso639_2": { "id": "en", "localized_labels": { "en": "English", "fi": "englanti", "sv": "engelska" } } |
language_iso639_2 | identified object | julkaisukielen ISO-639-3 tiedot. | |
| level | int | julkaisukanavan tasoluokka | 2026 → Value mapping: 0 → "Other identified publication channels", 1 → 1, 2 → 2, 3 → 3 |
| level_history | [object] | arviointihistoria | "level_history": {
"2012": "",
"2013": "",
"2014": "",
"2015": "",
"2016": "",
"2017": "",
"2018": "",
"2019": "",
"2020": "",
"2021": "",
"2022": "",
"2023": "",
"2024": "1",
"2025": "1"
} |
| level_pending | int | julkaisukanavan tuleva tasoluokka seuraavan vuoden alusta alkaen | |
| modified | str | julkaisukanavan tietojen viimeisin muokkauspäivämäärä | |
| title | str | julkaisukanavan nimi | |
| okm_disciplines | [identified object] | julkaisukanavan OKM-tieteenalat | "okm_disciplines": [ { "id": "112", "localized_labels": { "en": "Statistics and probability 112", "fi": "112 Tilastotiede", "sv": "112 Statistik" } }, { "id": "113", "localized_labels": { "en": "Computer and information sciences 113", "fi": "113 Tietojenkäsittely ja informaatiotieteet", "sv": "113 Data- och informationsvetenskap" } }, { "id": "1172", "localized_labels": { "en": "Environmental sciences 1172", "fi": "1172 Ympäristötiede", "sv": "1172 Miljövetenskap" } } ] |
| title_other | str | julkaisukanavan ala- tai rinnakkaisnimike | |
| panels | [int] | arviointipaneeli | [23] |
| publisher_name | str | julkaisija | |
| title_details | str | lisätietoja julkaisukanavasta | |
| type | identified object | julkaisukanavan tyyppitiedot | "type": { "id": "Series", "localized_labels": { "en": "Series", "fi": "Lehdet ja sarjat", "sv": "Tidskrift/serie" } } |
| website | str | linkki julkaisukanavan kotisivulle | |
| year_end | int | julkaisukanavan päätösvuosi | |
| year_start | int | julkaisukanavan aloitusvuosi |