Luettelointirajapinnalla voi hakea ja muokata bibliografisia tietueita. Rajapinta on toteutettu HTTP REST arkkitehtuurimallilla.


Tämä rajapinta perustuu Melindan nykyisen kirjastojärjestelmän ominaisuuksiin, älä käytä uuden integraation kehittämiseen.

Ota yhteyttä melinda-posti(at)helsinki.fi, jos suunnittelet uutta Melinda-integraatiota.



Yhteysosoitteet

Testi

URL: https://melinda-test.kansalliskirjasto.fi/API/v1/

Protokollat: https

Tunnistautuminen

Toteutus on HTTP Basic Access autentikaation mukainen ja tapahtuu käyttäjätunnus-salasanaparilla. Käyttäjätunnukset voi tilata sähköpostitse osoitteesta [email protected].

GET-pyynnöt

GET-metodilla tehdyt pyynnöt eivät vaadi tunnistautumista.

Resurssit

/bib

Metodi
Kuvaus
Parametrit
Pyynnön sisältötyypit
Vastauksen sisältötyypit
Esimerkki
POSTLuo uusi tietue

check (boolean) : Tarkista sisällön oikeellisuus mutta älä tallenna sitä

bypass_low_validation (boolean) : Tallenna tietue vaikka tallentajalla ei olisi käyttöoikeuksia kaikkiin muutettuihin LOW-kenttiin

bypass_index_check (boolean): Ohita tallennettaessa standardinumeroiden perusteella tehtävä tuplatarkistus

text/xml text/xml 
POST /API/v1/bib/ HTTP/1.1
Authorization: Basic xxxxxxxxxxxxxxxxxxxxxxxxx
Host: melinda-test.kansalliskirjasto.fi/
Content-Type:text/xml
Content-Length: 1601

          

        
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8

<response>
  <message>[0018] Document: 00XXXXXXX was updated successfully.</message>
  <session-id>XXXXXXXXXXXXXXXX</session-id>
</response>

/bib/:id

Metodi
Kuvaus
Parametrit
Pyynnön sisältötyypit
Vastauksen sisältötyypit
Esimerkki
GETHae tietue

handle_deleted (boolean): Palauta tietue, vaikka se olisi tietokannassa merkitty poistetuksi

no_rerouting (boolean): Jos tietue on merkitty tietokannassa poistetuksi, älä palauta korvaavaa tietuetta, vaikka sellainen löytyisi


 text/xml 
GET /API/v1/bib/1234 HTTP/1.1
Host: melinda-test.kansalliskirjasto.fi/
          
HTTP/1.1 200 OK


Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="UTF-8"?>
<record><leader>00000cam^a22002177i^4500</leader><controlfield tag="001">000001234</controlfield>
<controlfield tag="003">FI-MELINDA</controlfield><controlfield tag="005">20141229140637.0</controlfield>
<controlfield tag="008">900214s1980^^^^sw^||||||m^^^|||||||eng||</controlfield>
...
PUTPäivitä tietuetta

check (boolean) : Tarkista sisällön oikeellisuus mutta älä tallenna sitä

bypass_low_validation (boolean) : Tallenna tietue vaikka tallentajalla ei olisi käyttöoikeuksia kaikkiin muutettuihin LOW-kenttiin

bypass_index_check (boolean): Ohita tallennettaessa standardinumeroiden perusteella tehtävä tuplatarkistus

handle_deleted (boolean): Salli tietueen tallennus, vaikka se olisi tietokannassa merkitty poistetuksi


 text/xml text/xml 
PUT /API/v1/bib/1234 HTTP/1.1
Authorization: Basic xxxxxxxxxxxxxxxxxxxxxxxxx
Host: melinda-test.kansalliskirjasto.fi/
Content-Type:text/xml
Content-Length: 1601

          

        
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8

<response>
  <message>[0018] Document: 00XXXXXXX was updated successfully.</message>
  <session-id>XXXXXXXXXXXXXXXX</session-id>
</response>

/bib/:id/children

Metodi
Kuvaus
Parametrit
Pyynnön sisältötyypit
Vastauksen sisältötyypit
Esimerkki
GET

Hae tietueen osakohdetietueet

Huom: oletuksena palauttaa vain monoemon osakohteet (MARC 21: LDR/07 = 'a')

limit (number) : Palautettavien osakohteiden maksimäärä. Osakohteiden kokonaismäärä ilmoitetaan collection-elementin allRecordsCount-ominaisuudella.

start (number) : Indeksi josta lähtien osakohteita palautetaan (Ensimmäisen osakohteen järjestysnumero on 0). Valittu järjestysnumero ilmoitetaan collection-elementin firstRecordNumber-ominaisuudella

include_parent (boolean) : Palauta myös itse emotietue osakohteiden mukana

include_nonmono (boolean): Palauta myös ei-monoemon osakohteet (MARC 21: LDR/07 != 'a') 


 text/xml 
GET /API/v1/bib/1234/children HTTP/1.1
Host: melinda-test.kansalliskirjasto.fi/

          

        
HTTP/1.1 200 OK


<collection allRecordsCount="0">
</collection>



Parametrit

Parametrin tyyppi ilmoitetaan nimen perässä:

parametri (string): Merkkijonoparametri


Vapaaehtoiset parametrit on kursivoitu:

pakollinen (string) : Pakollinen parametri

vapaaehtoinen (boolean) : Vapaaehtoinen parametri

Vastauskoodit

Kirjastojärjestelmän palauttamat vastauskoodit

  • No labels