...
Info | ||
---|---|---|
| ||
This page is not completed. The work on specifications is ongoing. Everyone is welcome to comment or contribute! |
Table of Contents | ||
---|---|---|
|
Details
Project Title: | DSpace REST API |
Student: | Bojan Suzic, University of Technology Graz |
Mentors: | Aaron Zeckoski, Mark Diggory |
Contacting author: | bojan AT student . tugraz DOT at - using subject line DSpace |
SCM Location for Project: | http://scm.dspace.org/svn/repo/modules/rest |
...
Name and description | Value and notes |
---|---|
Base URI: | /collections/ |
Description: | Returns a list of all items from the collection |
HTTP method: | |
Optional parameters: |
|
Sorting fields supported: | |
Response formats: | |
Status codes | 200: OK |
Response details |
|
Content searching
Name and description | Value and notes |
---|---|
Base URI: |
|
Description: | Returns a list of all objects found by searching criteria |
HTTP method: | |
Optional parameters: |
|
Sorting fields supported: | |
Sorting/ordering modifiers: | |
Response formats: | |
Status codes | 200: OK |
Response details |
|
Name and description | Value and notes |
---|---|
Base URI: |
|
Description: | Returns a list of all objects that have been created, modified or withdrawn within specified time range |
HTTP method: | |
Optional parameters: |
|
Sorting/ordering modifiers: | |
Response formats: | |
Status codes | 200: OK |
Response details |
|
Item status and retrieval
Name and description | Value and notes |
---|---|
Base URI: | |
Description: | Returns detailed information about an item |
HTTP method: | |
Required parameters: | { |
Sorting fields supported: | |
Response formats: | |
Status codes | 200: OK |
Response details | Contains an information about an item including resource name, metadata, owning collection, collections stored in, communities stored in, bundle ids, last modified date, archival/withdrawn status and submitter of an item |
Name and description | Value and notes |
---|---|
Base URI: | |
Description: | Returns status of user permissions on this item |
HTTP method: | |
Required parameters: | { |
Response formats: | |
Status codes | 200: OK |
Response details | Boolean variable, stating can user edit the listed item |
Name and description | Value and notes |
---|---|
Base URI: |
|
Description: | Returns communities this item is part of |
HTTP method: | |
Required parameters: | |
Sorting fields supported: | |
Response formats: | |
Status codes | 200: OK |
Response details | Communities listed |
Name and description | Value and notes |
---|---|
Base URI: |
|
Description: | Returns collections this item is part of |
HTTP method: | |
Required parameters: | |
Sorting fields supported: | |
Response formats: | |
Status codes | 200: OK |
Response details | Collections listed |
Name and description | Value and notes |
---|---|
Base URI: | |
Description: | Returns bitstream object - usually the library item file |
HTTP method: | |
Required parameters: | { |
Response formats: | |
Status codes | 200: OK |
Response details | Includes all information about referenced bitstream, including file name, licence, corresponding ittem etc. It is possible only to get information for particular bitstreams. When the request is made without parameters/references, the blank list is presented (there is no list of all bitstreams in the system available). |
Name and description | Value and notes |
---|---|
Base URI: | |
Description: | Returns checksum of bitstream |
HTTP method: | |
Required parameters: | { |
Response formats: | |
Status codes | 200: OK |
Response details | Receive full bitstream |
User oriented functions
Name and description | Value and notes |
---|---|
Base URI: |
|
Description: | Returns list containing id, name and email of persons (optionally matching a query) |
HTTP method: | |
Optional parameters: | |
Sorting fields supported: | |
Response formats: | |
Status codes | 200: OK |
Response details | List with information on particular user. Additionaly only identifiers are sent if idOnly is true. |
Statistical info
Name and description | Value and notes |
---|---|
Base URI: | |
Description: | Returns general statistics |
HTTP method: | |
Response formats: | |
Status codes | 200: OK |
Response details | Returns cummulative list of statistics data for the system currently available |