Versiohistoria:
v1.1
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.
Esimerkkitoteutus (html/javascript) löytyy osoitteesta: https://jufo-rest.csc.fi/demo/demo.html
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 |
[{"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
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 |
[{"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 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ä.
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".