Versiohistoria:
v1.1
- 2023-12-01 muutettu SJR_SJR, SNIP ja IPP kenttien arvoksi aina "".
- Aikaisemmin näytetyt tiedot ovat jo vanhentuneet ja uusia tietoja ei enää saada. Tulevista rajapintaversioista nämä kentät poistetaan kokonaan.
- 2023-05-29 lisätty ReEvaluation kenttä massa.json.zip (v.1.1) sisältöön.
- 2023-01-26 lisätty Fields kentän arvo https://jufo-rest.csc.fi/v1.1/massa.json.zip tiedoston sisältöön
- 2023-01-09 lisätty kenttä jufo_2022
- 2022-02-11 lisätty kentät Jufo_2020 ja Jufo_2021
- 2019-04-26 lisätty seuraavat kentät: Jfi_Index, Bfeld_Index, Virta_Gold, Virta_Hybrid, Virta_Green
...
v1.0 - alkuperäinen rajapintatoteutus. Esimerkkihakuja https://jufo-rest.csc.fi/v1.0/kanava/50001
REST-rajapinnan avulla voit integroida Julkaisufoorumin julkaisukanavatietokannan osaksi omia tietojärjestelmiäsi. Rajapinta on julkinen. Voit etsiä yksittäisiä julkaisukanavia ISSN-tunnisteen, ISBN-tunnisteen tai nimen perusteella tai hakea koko julkaisukanavan tietosisällön kerralla. Rajapinta palauttaa julkaisukanavatietokannan sisällön JSON-formaatissa, josta alla tarkemmat kuvaukset. Rajapinta tukee W3C Cross-Origin Resource Sharing (CORS) -toiminnallisuutta.
...
Rajapinnan toiminnallisuuksia:
ETSI
ETSI-sovelluksella voit etsiä julkaisukanavia eri hakukriteereitä käyttäen. Sovelluksen kutsuosoite https://jufo-rest.csc.fi/v1.1/etsi.php
...
| parametrin nimi | kuvaus | sallitut merkit | pituus(max) | huomioita |
|---|---|---|---|---|
| nimi | Julkaisukanavan nimi | a-Z0-9 | 50 | Voit hakea julkaisukanavaa nimellä tai sen osalla |
| isbn | ISBN tunniste (juuri) | 0-9- | 20 | ISBN-tunnisteen juuri numerokoodina, esim. 978-963-46. Julkaisukanavatietokannassa on vain ISBN-tunnisteen juuriosa eli kustantajan tunniste. |
| issn | ISSN tunniste | 0-9- | 10 | Julkaisukanavan ISSN-tunniste |
| lyhenne | Konferenssin lyhenne | a-Z0-9 | 20 | Konferenssin vakiintunut lyhenne |
| tyyppi | Julkaisukanavan tyyppi | 1-3 | 1 | 1=Lehti/Sarja 2=Kirjakustantaja, 3=Konferenssi. Rajaava hakutekijä. |
Rajapinta palauttaa seuraavat tiedot:
...
| parametrin nimi | kuvaus | sallitut merkit | pituus(max) | huomioita |
|---|---|---|---|---|
| /Jufo_ID | Julkaisukanavan JUFO-ID-tunniste | 0-9 | 11 |
Kutsu palauttaa seuraavat tiedot
...
https://jufo-rest.csc.fi/v1.1/kanava/64592
Koko julkaisukanavatietokannan sisällön hakeminen
...
Molemmat tiedostot päivitetään kerran yössä.
Poikkeustilanteet
Jos julkaisukanavaa ei löydy rajapinta palauttaa tyhjän JSON-tiedoston vastauksena. Mikäli parametrien käsittelyssä on virhe (väärä parametri), palauttaa rajapinta http status -koodin 400 "Bad Request".