Versions Compared

Old Version 3

changes.mady.by.user Minttu Hurme

Saved on

compared with

New Version 4

changes.mady.by.user Aatu Nykänen

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

URL: http://libtest1.csc.fi:8992/API/v1/

Protokollat: http 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].

...

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: libtest.csc.fi:8992
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>

...

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: libtest1.csc.fi:8992
          
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: libtest.csc.fi:8992
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>

...

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

Hae tietueen osakohdetietueet

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

  text/xml 
GET /API/v1/bib/1234/children HTTP/1.1
Host: libtest1.csc.fi:8992

          

        
HTTP/1.1 200 OK

 

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

...