Skip to end of metadata
Go to start of metadata

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 palauttavat JSON-muodossa suppeamman tietojoukon,  jossa on vain osa julkaisujen perustiedoista. Hakutulokset saa myös XML-muodossa, jolloin palautuvat kaikki tiedot. Katso hakuesimerkit ohjeen loppupuolelta.

JSON-muodossa palautettavat tiedot:

"julkaisunTunnus" ,"julkaisunNimi","tekijat","julkaisuVuosi","julkaisuTyyppi","lehdenNimi","issn","muutospvm","luontipvm","julkaisunTila,"julkaisunOrgTunnus", "jufoTunnus", "organisaatioTunnus" ja "ilmoitusVuosi"

XML-muodossa palautettavat tiedot:

Katso Julkaisut-XML skeeman määrittelytiedot ja kuvaukset.

Hakuparametrit

NimiPakollisuusLyhyt kuvausLisätietojaVakioarvoSchema
etunimieiOrganisaation tekijän etunimet (vapaatekstihaku)3.3.1.4-string
sukunimieiOrganisaation tekijän sukunimi (vapaatekstihaku)3.3.1.4-string
henkiloHakueiTekijähaku kaikista tekijäkentistä (vapaatekstihaku)3.3.1.6-string
julkaisunNimieiJulkaisun nimi (vapaatekstihaku)3.3.1.10-string
lehdenNimieiLehden nimi  (vapaatekstihaku)3.3.1.17-string
julkaisuVuosieiJulkaisuvuosi3.3.1.11-string
organisaatioTunnuseiOrganisaatiotunnuskoodistot-string
julkaisunOrgTunnuseiOrganisaation julkaisulle antama yksilöivä tunnus.3.3.1.32-string
orcideiORCID -tunniste3.3.1.35-string
julkaisuTyyppieiJulkaisun tyyppikoodi3.3.1.1-string
julkaisunTilaeiJulkaisun tilakoodikoodistot-string
issneiISSN3.3.1.18-string
isbneiISBN3.3.1.19-string
kustantajanNimieiKustantajan nimi (vapaatekstihaku)3.3.1.22-string
doieiDOI3.3.1.26-string
muutospvmAlkueiMuutospäivämäärästä lähtien, (Date ISO-8601 -formaatti, esim. 2016-03-22T07:52:44Z) -string
muutospvmLoppuei

Muutospäivämäärään asti (Date ISO-8601 -formaatti, esim. 2016-03-22T07:52:44Z)

 -string
luontipvmAlkueiLuontipäivämäärästä lähtien, (Date ISO-8601 -formaatti, esim. 2016-03-22T07:52:44Z) -string
luontipvmLoppueiLuontipäivämäärään asti, (Date ISO-8601 -formaatti, esim. 2016-03-22T07:52:44Z) -string
yhteisJulkaisunTunnuseiUseista organisaatioista raportoitu julkaisu tunnistetaan yhteisjulkaisuksi, jota varten muodostetaan tietovarannossa CSC:llä yhteisjulkaisua varten uusi tietue ja sille tunnus automaattisesti. -string
jufoTunnuseiJulkaisukanavan Jufo-ID-tunniste, joka on  luokituksen mukainen 4/5 -numeroinen arvo, esim. 5003.3.3.1.31-string
ilmoitusVuosieiVuosi, 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://virta-jtp.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://virta-jtp.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://virta-jtp.csc.fi/api/julkaisut/haku?lehdenNimi=Suomen%20L%C3%A4%C3%A4k%C3%A4rilehti&julkaisuTyyppi=A1

# curl  -k -i -H "Accept: application/json" https://virta-jtp.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 tapahtuu JulkaisunTunnus arvon perusteella. Kyseessä on Julkaisun yksiselitteisesti identifioiva koodi. Samalla julkaisulla ei voi olla olemassa useampaa julkaisuntunnusta. Julkaisuntunnuksia voi etsiä yllä olevan hakutoiminnallisuuden perusteella.

 

Hakuesimerkkejä

# curl -k -i -H "Accept: application/xml" https://virta-jtp.csc.fi/api/julkaisut/xml/000051414

# curl -k -i -H "Accept: application/json" https://virta-jtp.csc.fi/api/julkaisut/000051414


Rajoitetun pääsyn rajapinnat

Julkaisutiedonkeruun rajapinta sisältää myös muita rajapintoja mutta ne on tarkoitettu vain nimettyä käyttötarkoitusta varten ja niihin pääsyä on rajoitettu. Kyseiset rajapinnat sisältävät toiminnallisuuksia esimerkiksi tietojen syöttämistä varten tai sisältävät historiatietoa esimerkiksi tilastollisia tarkoituksia varten.

Näitä rajapintoja ovat mm:

/julkaisut/{julkaisunTunnus}/hanke
/julkaisut/{julkaisunTunnus}/juuli
/TKjulkaisut


Esimerkkivastauksia


Yksittäisen julkaisun tiedot XML-muodossa: 0010696814.xml

Yksittäisen julkaisun tiedot JSON-muodossa:0010696814.json

Hakutulokset JSON-muodossa:haku.json

 

 

 

Write a comment…