Julkaisukanavatietokannan REST-rajapinta

Versiohistoria:

v1.1

2024-01-09 kenttämuutoksia massa.json tiedostoon.
- poistettu
  - Sherpa_Romeo_Code
  - SJR_SJR
  - SNIP
  - IPP
  - Denmark_Level
  - Predator
- Lisätty
  - newLevel
  - sherpaIndex
  - oaType
  - saAllowed
  - Jufo_2023
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

lisätty ammatilliset ja yleistajuiset julkaisukanavat sekä kentät Jufo_2016, Jufo_2017, Jufo_2018 ja Jufo_2019. Esimerkkihakuja https://jufo-rest.csc.fi/v1.1/kanava/50001, https://jufo-rest.csc.fi/v1.1/kanava/55163489. HUOM! versio 1.0 ei palauta uusia kenttiä.

v1.0 - alkuperäinen rajapintatoteutus. Esimerkkihakuja https://jufo-rest.csc.fi/v1.0/kanava/50001

2024-01-09 kenttämuutoksia massa.json tiedostoon.
- poistettu
  - Sherpa_Romeo_Code
  - SJR_SJR
  - SNIP
  - IPP
  - Denmark_Level
  - Predator
- Lisätty
  - newLevel
  - sherpaIndex
  - oaType
  - saAllowed

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.

Esimerkkitoteutus (html/javascript) löytyy osoitteesta: https://jufo-rest.csc.fi/demo/demo.html

Rajapinnan toiminnallisuuksia:

ETSI

ETSI-sovelluksella voit etsiä julkaisukanavia eri hakukriteereitä käyttäen. Sovelluksen kutsuosoite https://jufo-rest.csc.fi/v1.1/etsi.php

Parametrit:

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:

kenttä	kuvaus	tyyppi	huomioita
JUFO_ID	Julkaisukananavan JUFO-ID-tunniste	int(11)	Julkaisukanavan yksilöivä tunniste
Link	URL julkaisukanavan tietoihin	varchar(50)	esimerkiksi: https://jufo-rest.csc.fi/v1.1/kanava/64592
Name	Julkaisukanavan nimi	varchar(255)
Type	Julkaisukanavan tyyppi	varchar(45)	Lehti/Sarja, Kirjakustantaja tai konferenssi

JSON-esimerkki: https://jufo-rest.csc.fi/v1.1/etsi.php?nimi=artificial%20intelligence

[{"Jufo_ID":"50460","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/50460","Name":"Advances in artificial intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"50704","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/50704","Name":"Ai edam-artificial intelligence for engineering design analysis and manufacturing","Type":"Lehti\/sarja"},{"Jufo_ID":"51235","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/51235","Name":"Annals of mathematics and artificial intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"51463","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/51463","Name":"Applied artificial intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"51837","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/51837","Name":"Artificial intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"51838","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/51838","Name":"Artificial intelligence and law","Type":"Lehti\/sarja"},{"Jufo_ID":"51839","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/51839","Name":"Artificial intelligence in medicine","Type":"Lehti\/sarja"},{"Jufo_ID":"51841","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/51841","Name":"Artificial intelligence review","Type":"Lehti\/sarja"},{"Jufo_ID":"55173","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/55173","Name":"Electronic transactions on artificial intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"55266","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/55266","Name":"Engineering applications of artificial intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"56381","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/56381","Name":"Frontiers in artificial intelligence and applications","Type":"Lehti\/sarja"},{"Jufo_ID":"58252","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/58252","Name":"International journal of artificial intelligence in education","Type":"Lehti\/sarja"},{"Jufo_ID":"58705","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/58705","Name":"International journal of pattern recognition and artificial intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"58921","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/58921","Name":"International journal on artificial intelligence tools","Type":"Lehti\/sarja"},{"Jufo_ID":"59652","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/59652","Name":"Journal of artificial intelligence research","Type":"Lehti\/sarja"},{"Jufo_ID":"60358","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/60358","Name":"Journal of experimental and theoretical artificial intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"63729","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/63729","Name":"Proceedings of the AAAI Conference on Artificial Intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"70894","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/70894","Name":"Journal of artificial intelligence and soft computing research","Type":"Lehti\/sarja"},{"Jufo_ID":"71419","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/71419","Name":"Scandinavian conference on artificial intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"72036","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/72036","Name":"Proceedings : International Conference on Tools with Artificial Intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"73698","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/73698","Name":"Proceedings of the Innovative Applications of Artificial Intelligence Conference","Type":"Lehti\/sarja"},{"Jufo_ID":"75991","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/75991","Name":"International journal of artificial intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"76036","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/76036","Name":"International journal of interactive multimedia and artificial intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"81911","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/81911","Name":"International journal of advanced research in artificial intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"84660","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/84660","Name":"Progress in artificial intelligence","Type":"Lehti\/sarja"},{"Jufo_ID":"85066","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/85066","Name":"Advances in distributed computing and artificial intelligence journal","Type":"Lehti\/sarja"},{"Jufo_ID":"","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/","Name":"Publications of the Finnish Artificial Intelligence Society","Type":"Lehti\/sarja"},{"Jufo_ID":"","Link":"https:\/\/jufo-rest.csc.fi\/v1.0\/kanava\/","Name":"Publications of the Finnish Artificial Intelligence Society. International Conferences","Type":"Lehti\/sarja"}]

Esimerkki hakuja

Haetaan julkaisukanavan tietoja nimen perusteella.

https://jufo-rest.csc.fi/v1.1/etsi.php?nimi=Oxford

Haetaan Julkaisukanavatietokannasta kirjakustantajia nimen perusteella

https://jufo-rest.csc.fi/v1.1/etsi.php?nimi=Oxford&tyyppi=2

Haku ISBN-tunnisteen perusteella:

https://jufo-rest.csc.fi/v1.1/etsi.php?isbn=978-87-7496&tyyppi=2

Yksittäisen julkaisukanavan hakeminen

Toiminnallisuudella voidaan hakea yksittäisen julkaisukanavan tiedot. Toiminnallisuus löytyy osoitteessa.https://jufo-rest.csc.fi/v1.1/kanava/

Parametrit:

parametrin nimi	kuvaus	sallitut merkit	pituus(max)	huomioita
/Jufo_ID	Julkaisukanavan JUFO-ID-tunniste	0-9	11

Kutsu palauttaa seuraavat tiedot

Kenttä	tyyppi	kuvaus
Jufo_ID	int(11)	Unique channel identifier
Level	int(4)	Current level
Name	varchar(255)	Name
Abbreviation	varchar(100)	Conference abbreviation
Other_Title	varchar(255)	Other language title or form
Title_Details	varchar(255)	Comments on the title
ISSNL	varchar(45)	ISSNL
ISSN1	varchar(45)	ISSN-print
ISSN2	varchar(45)	ISSN-online
ISBN	varchar(200)	ISBN-codes
Continues	varchar(255)	Jufo_ID of the predecessor
Continued_by	varchar(255)	Jufo_ID of the successor
Type	varchar(45)	Journal/series, Conference, or Book publisher
Website	varchar(1000)	WWW-link
Country	varchar(45)	Publishing country
Publisher	varchar(170)	Publisher (and society)
Language	varchar(200)	Publishing languages
Year_Start	int(11)	Start year
Year_End	int(11)	End year
Active	varchar(45)	Active if no end year, Inactive if end year
Norway_Level	int(4)
Denmark_Level	int(4)
SJR_SJR	decimal(6,3)
SNIP	varchar(45)
IPP	varchar(45)
DOAJ_Index	int(11)	1 indicates channels indexed in DOAJ
Jfi_Index	int(11)	1 indicates channels indexed in Journal.fi
Bfeld_Index	int(11)	1 indicates channels indexed in Bielefeld list
Virta_Gold	int(11)	1 indicates Virta gold channel
Virta_Hybrid	int(11)	1 indicates Virta hybrid channel
Virta_Green	int(11)	1 indicates Virta green channel
Sherpa_Romeo_Code	varchar(45)	Green, Blue, Yellow, White
CreatedAt	datetime	Date of creation of Jufo_ID (2012-12-12 12:12:12)
ModifiedAt	datetime	Date of latest modification Jufo_ID (2012-12-12 12:12:12)
Active_Binary	int(1)	1 indicates included, 0 excluded channels (e.g. duplicates)
Jufo_2012	int(4)	2012 level
Jufo_2013	int(4)	2013 level
Jufo_2014	int(4)	2014 level
Jufo_2015	int(4)	2015 level
Jufo_2016	int(4)	2016 level
Jufo_2017	int(4)	2017 level
Jufo_2018	int(4)	2018 level
Jufo_2019	int(4)	2019 level
Fields	varchar(100)	Codes for ERIH, Norwegian, Danish, WOS, Sopus, and MinEdu -fields
Scientific	int(1)	1 Indicates scientific publications channel
Professional	int(1)	1 indicates professional publication channel
General	int(1)	1 indicates genera public publication channel
Jufo_History	varchar(300)	All time jufo levels

JSON-esimerkki: https://jufo-rest.csc.fi/v1.1/kanava/64592

[{"Jufo_ID":"64592","Level":"2","Name":"Oxford journal of archaeology","Abbreviation":"","Other_Title":"","Title_Details":"","ISSNL":"","ISSN1":"0262-5253","ISSN2":"1468-0092","ISBN":"","Continues":"","Continued_by":"","Type":"Lehti\/sarja","Field":";5 Yhteiskuntatieteet;6 Humanistiset tieteet;","Subfield":";519 Yhteiskuntamaantiede, talousmaantiede;615 Historia ja arkeologia;616 Muut humanistiset tieteet;","Website":"","Country":"UNITED KINGDOM","Publisher":"Wiley-Blackwell Publishing Ltd.; Oxford University","Language":"English","Year_Start":"1982","Year_End":"","Active":"Active","Norway_Level":"2","Denmark_Level":"2","SJR_SJR":"0.540","SNIP":"0.996","IPP":"0.831","DOAJ_Index":"0","Sherpa_Romeo_Code":"Yellow","CreatedAt":"2012-12-12 12:12:12","ModifiedAt":"2015-05-25 15:29:38","Active_Binary":"1","Predator":"0","Jufo_2012":"3","Jufo_2013":"3","Jufo_2014":"3","Jufo_2015":"2","Fields":"519 Yhteiskuntamaantiede, talousmaantiede; 615 Historia ja arkeologia; 616 Muut humanistiset tieteet","Scientific":"0","Professional":"0"}]

Esimerkkihakuja:

https://jufo-rest.csc.fi/v1.1/kanava/64592

Koko julkaisukanavatietokannan sisällön hakeminen

Koko julkaisukanavatietokannan sisällön voi hakea JSON-muodossa osoitteesta https://jufo-rest.csc.fi/v1.1/massa.json.zip

VirtaAdditions-taulun Jufo_ID, JulkaisunTunnus, CreatedAt ja ModifiedAt tiedot löytyvät JSON-muodossa osoitteesta https://jufo-rest.csc.fi/v1.1/virta-additions-massa.json.zip

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".

Page tree