Julkaisukanavatietokannan REST-rajapinta
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.0/etsi.php
...
https://jufo-rest.csc.fi/v1.0/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.0/kanava/
...
https://jufo-rest.csc.fi/v1.0/kanava/64592
Koko julkaisukanavatietokannan sisällön hakeminen
Koko julkaisukanavatietokannan sisällön voi hakea JSON-muodossa osoitteesta https://jufo-rest.csc.fi/v1.0/massa.json.zip
Massa,json tiedosto 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".
...