Julkaisutietopalvelun tietoja voi hakea julkisen REST-rajapinnan kautta. Rajapintaa pääsee käyttämään ilmoittamalla teknisen yhteyshenkilön yhteystiedot (nimi, organisaatio, sähköposti ja puhelin) ja IP-osoitteen, josta rajapintaa haluaa käyttää sähköpostiosoitteeseen virta-julkaisut@postit.csc.fi
Rajapinta tarjoaa työkalut julkaisujen etsimiseen eri hakukriteerien perusteella, sekä yksittäisen että useamman julkaisun hakemiseen. Julkaisut ovat saatavilla sekä JSON- että XML-muodossa (Julkaisu-XML) .
Lisätietoja ja ohjeita rajarinnan käytöstä saa osoitteesta: virta-julkaisut@postit.csc.fi
Julkiset rajapinnat
Hakupalvelu
/julkaisut/haku
/julkaisu/haku/xml
Hakutulokset paluttavat JSON-muodossa suppeamman tietojoukon, jossa on vain osa julkaisujen perustiedoista. Nämä tiedot ovat julkaisunTunnus, julkaisunNimi, tekijat, julkaisuVuosi, lehdenNimi, issn, muutospvm ja julkaisunTila. Hakutulokset saa myös XML-muodossa, jolloin palautuvat kaikki tiedot. Katso hakuesimerkit ohjeen loppupuolelta.
Hakuparametrit
Nimi | Pakollisuus | Lyhyt kuvaus | Lisätietoja | Vakioarvo | Schema |
---|---|---|---|---|---|
etunimi | ei | Organisaation tekijän etunimet (vapaatekstihaku) | 3.3.1.4 | - | string |
sukunimi | ei | Organisaation tekijän sukunimi (vapaatekstihaku) | 3.3.1.4 | - | string |
henkiloHaku | ei | Tekijähaku kaikista tekijäkentistä (vapaatekstihaku) | 3.3.1.6 | - | string |
julkaisunNimi | ei | Julkaisun nimi (vapaatekstihaku) | 3.3.1.10 | - | string |
lehdenNimi | ei | Lehden nimi (vapaatekstihaku) | 3.3.1.17 | - | string |
julkaisuVuosi | ei | Julkaisuvuosi | 3.3.1.11 | - | string |
organisaatioTunnus | ei | Organisaatiotunnus | koodistot | - | string |
orcid | ei | ORCID -tunniste | 3.3.1.35 | - | string |
julkaisuTyyppi | ei | Julkaisun tyyppikoodi | 3.3.1.1 | - | string |
julkaisunTila | ei | Julkaisun tilakoodi | koodistot | - | string |
issn | ei | ISSN | 3.3.1.18 | - | string |
isbn | ei | ISBN | 3.3.1.19 | - | string |
kustantajanNimi | ei | Kustantajan nimi (vapaatekstihaku) | 3.3.1.22 | - | string |
doi | ei | DOI | 3.3.1.26 | - | string |
muutospvmAlku | ei | Muutospäivämäärästä lähtien, (Date ISO-8601 -formaatti, esim. 2016-03-22T07:52:44Z) | - | string | |
muutospvmLoppu | ei | Muutospäivämäärään asti (Date ISO-8601 -formaatti, esim. 2016-03-22T07:52:44Z) | - | string | |
luontipvmAlku | ei | Luontipäivämäärästä lähtien, (Date ISO-8601 -formaatti, esim. 2016-03-22T07:52:44Z) | - | string | |
luontipvmLoppu | ei | Luontipäivämäärään asti, (Date ISO-8601 -formaatti, esim. 2016-03-22T07:52:44Z) | - | string | |
yhteisJulkaisunTunnus | ei | Useista organisaatioista raportoitu julkaisu tunnistetaan yhteisjulkaisuksi, jota varten muodostetaan tietovarannossa CSC:llä yhteisjulkaisua varten uusi tietue ja sille tunnus automaattisesti. | - | string | |
jufoTunnus | no | Julkaisukanavan Jufo-ID-tunniste, joka on luokituksen mukainen 4/5 -numeroinen arvo, esim. 5003. | 3.3.1.31 | - | string |
ilmoitusVuosi | no | Vuosi, jona julkaisu on ilmoitettu ensimmäisen kerran. | - | string |
Hakuesimerkkejä
Useamman julkaisun tieojen hakeminen. Haetaan lehden nimen ja organisaatiotunnuksen mukaan (XML ja JSON (julkaisusjen perustiedot)).
Esimerkissä lehtenä on Suomen lääkärilehti nimi URL enkoodattuna.
# curl -k -i -H "Accept: application/xml" https://dwitjutife1.csc.fi/api/julkaisut/haku/xml?lehdenNimi=Suomen%20L%C3%A4%C3%A4k%C3%A4rilehti&organisaatioTunnus=01901
# curl -k -i -H "Accept: application/json" https://dwitjutife1.csc.fi/api/julkaisut/haku?lehdenNimi=Suomen%20L%C3%A4%C3%A4k%C3%A4rilehti&organisaatioTunnus=01901
Haettavien julkaisujen rajaaminen julkaisutyypin perusteelle. Muut hakuehdot: Lehti: ”Suomen Lääkärilehti” ja Organisaatio on 01901
# curl -k -i -H "Accept: application/json" https://dwitjutife1.csc.fi/api/julkaisut/haku?lehdenNimi=Suomen%20L%C3%A4%C3%A4k%C3%A4rilehti&julkaisuTyyppi=A1
# curl -k -i -H "Accept: application/json" https://dwitjutife1.csc.fi/api/julkaisut/haku?julkaisuVuosi=2014&organisaatioTunnus=01901
Yksittäisen julkaisun tietojen hakeminen
/julkaisut
/julkaisut/xml
Yksittäisen julkaisun hakeminen rajapinnasta XML ja JSON muodossa
# curl -k -i -H "Accept: application/xml" https://dwitjutife1.csc.fi/api/julkaisut/xml/000051414
# curl -k -i -H "Accept: application/json" https://dwitjutife1.csc.fi/api/julkaisut/000051414
Rajoitetun pääsyn rajapinnat
Esimerkkivastauksia
Yksittäisen julkaisun tiedot XML-muodossa: 0010696814.xml
Yksittäisen julkaisun tiedot JSON-muodossa:0010696814.json
Hakutulokset JSON-muodossa:haku.json