Julkaisukanavatietokannan REST-rajapinta
REST rajapinan avulla voit integroida Tieteellisen seurain valtuuskunnan ylläpitämän julkaisukanavatietokannan osaksi omia tietojärjestelmiäsi. Rajapinta on julkinen. Voit etsiä yksittäisiä julkaisukanavia issn-, 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 toiminnallisuus:
ETSI
Etsi sovelluksella voit etsiä julkaisukanavia, eri hakukriteereitä käyttäen. Sovelluksen kutsuosoite https://kanava-dev.csc.fi/jufo/
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 Tunniste numerokoodina. esim. 978-963-46. Julkaisukanavatietokannassa on vain ISBN tunnisteen juuriosa eli kustantajan tunniste. |
issn | ISSN tunniste | 0-9- | 10 | Julkaisukanavan ISSN tunniste |
tyyppi | Julkaisukanavan tyyppi | 1-3 | 1 | 1=Lehti/Sarja 2=Kirjakustantaja, 3=Konferenssi. Rajaava hakutekijä. |
Rajapinta palauttaa seuraavat tiedot:
kenttä | kuavus | tyyppi | huomioita |
---|---|---|---|
JUFO_ID | Julkaisukananavan ID tunniste | int(11) | Julkaisukanavan yksilöivä tunniste |
Link | URL Julkaisukanavan tietoihin | varchar(50) | esimerkiksi: https://kanava-dev.csc.fi/jufo/kanava/64592 |
Name | Julkaisukanavan nimi | varchar(255) | |
Type | Julkaisukanavan tyyppi | varchar(45) | Lehti/Sarja, Kirjakustantaja tai konferenssi |
Esimerkki hakuja
Haetaan Julkaisukanava tietoja nimen perusteella.
https://kanava-dev.csc.fi/jufo/etsi.php?nimi=Oxford
Haetaan Julkaisukanavatietokannasta kirjakustantajia nimen perusteella
https://kanava-dev.csc.fi/jufo/etsi.php?nimi=Oxford&tyyppi=2
Haku ISBN numeron perusteella:
https://kanava-dev.csc.fi/jufo/etsi.php?isbn=978-87-7496&tyyppi=2
Yksittäisen Julkaisukanavan hakeminen
Toiminnallisuudella voidaan hakea yksittäisen julkaisukanavan tiedot. Toiminnallisuus löytyy osoitteessa. https://kanava-dev.csc.fi/jufo/
Parametrit:
parametrin nimi | kuvaus | sallitut merkit | pituus(max) | huomioita |
---|---|---|---|---|
/ | Julkaisukanavan ID tunniste | 0-9 | 11 |
Kutsu palauttaa seuraavat tiedot
Kenttä | tyyppi | DESCRIPTION |
---|---|---|
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 | ||
DOAJ_Index | 1 indicates channels indexed in DOAJ | |
Sherpa_Romeo_Code | Green, Blue, Yellow, White | |
CreatedAt | Date of creation of Jufo_ID | |
ModifiedAt | Date of latest modification Jufo_ID | |
Active_Binary | 1 indicates included, 0 excluded channels (e.g. duplicates) | |
Predator | 1 indicates channels included in Beall's list | |
Jufo_2012 | 2012 level | |
Jufo_2013 | 2013 level | |
Jufo_2014 | 2014 level | |
Jufo_2015 | 2015 level | |
Fields | Codes for ERIH, Norwegian, Danish, WOS, Sopus, and MinEdu -fields | |
Scientific | 1 Indicates scientific publications channel | |
Professional | 1 indicates professional publication channel | |
General | 1 indicates genera public publication channel |
Esimerkkihakuja:
https://kanava-dev.csc.fi/jufo/kanava/64592