REST - rajapinta

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

JSON-esimerkki

 [{"Jufo_ID":"64587","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/64587","Name":"Oxford art journal","Type":"Lehti\/sarja"},{"Jufo_ID":"64588","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/64588","Name":"Oxford bulletin of economics and statistics","Type":"Lehti\/sarja"},{"Jufo_ID":"64589","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/64589","Name":"Oxford development studies","Type":"Lehti\/sarja"},{"Jufo_ID":"64590","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/64590","Name":"Oxford economic papers: new series","Type":"Lehti\/sarja"},{"Jufo_ID":"64591","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/64591","Name":"Oxford german studies","Type":"Lehti\/sarja"},{"Jufo_ID":"64592","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/64592","Name":"Oxford journal of archaeology","Type":"Lehti\/sarja"},{"Jufo_ID":"64593","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/64593","Name":"Oxford journal of legal studies","Type":"Lehti\/sarja"},{"Jufo_ID":"64594","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/64594","Name":"Oxford literary review","Type":"Lehti\/sarja"},{"Jufo_ID":"64595","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/64595","Name":"Oxford review of economic policy","Type":"Lehti\/sarja"},{"Jufo_ID":"64596","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/64596","Name":"Oxford review of education","Type":"Lehti\/sarja"},{"Jufo_ID":"64597","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/64597","Name":"Oxford studies in ancient philosophy","Type":"Lehti\/sarja"},{"Jufo_ID":"64598","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/64598","Name":"Oxford studies in comparative education","Type":"Lehti\/sarja"},{"Jufo_ID":"64599","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/64599","Name":"Oxford studies in sociolinguistics","Type":"Lehti\/sarja"},{"Jufo_ID":"76379","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/76379","Name":"Oxford bibliographies","Type":"Lehti\/sarja"},{"Jufo_ID":"80111","Link":"https:\/\/kanava-dev.csc.fi\/jufo\/kanava\/80111","Name":"Oxford Philosophical Society Review","Type":"Lehti\/sarja"}]

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