Page History
Rest-rajapinnalla pääsee käsiksi ja muokkaamaan Dspacen resursseja, kuten kokoelmia, tietueita ja tiedostoja. Rajapinta tukee myös Dspacen omaa autentikointia, joten Restin kautta käyttäjällä on samat oikeudet resursseihin, kuin käyttöliittymänkin kautta.
DSpace 5.6 REST
Viralliset ohjeet löytyvät täältä. Virallisista ohjeista n Alle päivitetään käytännön esimerkkejä.
DSpace Rest Tokenin Hakeminen
Pyyntö osoitteeseen POST /rest/login, json payload:
Code Block language js {"email": "[email protected]", "password": "1234"}
Esimerkkivastaus:
Code Block 8a5bd933-e679-4ad3-8b5a-dd2a77941bff
Vastauksena saatu token pitää sisällyttää rest-dspace-token headeriin, kun tekee lisäys-/poisto-/muokkausoperaatioita.
Itemin lisääminen (embargolla tai ilman)
Note |
---|
Restin kautta embargo voidaan määritellä vain Dspacen omalla embargomekanismilla, jonka tarkkuus on vuorokausi. Siihen ei myöskään liity URN-pikarekisteröintiä. |
...
Code Block | ||
---|---|---|
| ||
curl --location --request POST 'https://doria.fi/rest/login' --header 'Content-Type: application/json' --data-raw '{"email":"user_email_here","password":"password_here"}'
curl --location --request POST 'https://doria.fi/rest/items/ITEM_ID_HERE/bitstreams?name=FILE_NAME_HERE' --header 'rest-dspace-token: TOKEN_HERE --header 'Content-Type: multipart/form-data' -F 'file=@FILE_PATH_HERE' |
...
- Nyt Item on luotu ja bitstream on lisätty.
Itemin metadatan päivittäminen
- Päivitä item: (rest osoite PUT /rest/items/{item_id}/metadata)
headerit:
Code Block rest-dspace-token: 8a5bd933-e679-4ad3-8b5a-dd2a77941bff Accept: application/json
json payload:
Code Block [{ "key": "dc.title", "value": "New Title", "language": "en" }]