...
Student: Bojan Suzic, University of Technology Graz
Mentor: Aaron Zeckoski
Contacting author: bojan AT trust - b . com using subject line \ [DSPACE:DSpace\] Wiki Markup
SCM Location for Project: http://scm.dspace.org/svn/repo/modules/rest
...
Name and description | Value and notes |
Base URI: |
|
Description: | Returns a list of all communities on the system or return just top level communities. |
HTTP method: | |
Optional parameters: |
|
Sorting fields supported: | |
Response formats: | |
Status codes | {{ 200: OK |
Response details |
|
Name and description | Value and notes |
Base URI: |
|
Description: | Returns a list of all parent communities of the |
HTTP method: | |
Optional parameters: |
|
Sorting fields supported: | |
Response formats: | |
Status codes | {{ 200: OK |
Response details |
|
Name and description | Value and notes |
Base URI: |
|
Description: | Returns a list of immediate sub-communities (children) of the |
HTTP method: | |
Optional parameters: |
|
Sorting fields supported: | |
Response formats: | |
Status codes | {{ 200: OK |
Response details |
|
Name and description | Value and notes |
Base URI: |
|
Description: | Returns a list of collections in the |
HTTP method: | |
Optional parameters: |
|
Sorting fields supported: | |
Response formats: | |
Status codes | {{ 200: OK |
Response details |
|
Name and description | Value and notes |
Base URI: |
|
Description: | Returns a list of recent submissions to a community |
HTTP method: | |
Optional parameters: |
|
Sorting fields supported: | |
Response formats: | |
Status codes | {{ 200: OK |
Response details |
|
Name and description | Value and notes |
Base URI: |
|
Description: | Returns a list of all collections in the system |
HTTP method: | |
Optional parameters: |
|
Sorting fields supported: | |
Response formats: | |
Status codes | {{ 200: OK |
Response details |
|
Name and description | Value and notes |
Base URI: |
|
Description: | Returns a list of all communities a collection with |
HTTP method: | |
Optional parameters: |
|
Sorting fields supported: | |
Response formats: | |
Status codes | {{ 200: OK |
Response details |
|
Name and description | Value and notes |
Base URI: |
|
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/info 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 |
...
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. |
...
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 |
...
We have something more like
Panelcode |
---|
/resource/{id}/related?relation=ds:isPartOfCommunity&idOnly=false&immediateOnly=true |
Rather than: /communities/{id}/children?idOnly=false&immediateOnly=tru
We have
Panelcode |
---|
/resource/{id}/related?relation=ds:hasCommunityPart&idOnly=false&immediateOnly=true |
I think we need to make sure the REST interfaces clearly map to 2.0 Services and the actions that can be performed on them. So harvest, stats and users make sense to me. But, Community, Collection, Item and Bitstream do not and we should be consolidating these under some service path like "content/" or "resource/" or the like.
...
Creates a new relationship in the object. Adds the specified relationship to the object's RELS-EXT datastream. If the Resource Index is enabled, the relationship will be added to the Resource Index.
The DSpace + 2.0 proposed mapping to Fedora places RDF references for ds:hasCollection/ds:isPartOfCollection, ds:hasCommunity/ds:isPartOfCommunity directly into the RELS-EXT as relationships between Fedora representations of DSpace objects.
URL Syntax
Panelcode |
---|
/objects/{pid} ? [relationship] [object] [isLiteral] [datatype] |
Parameters:
Panel |
---|
|
...
Get next pid, /objects/nextPID ? [DSPACE:type]
Code Block |
---|
/objects/nextPID?type="http://purl.org/dspace/model/Bitstream" /objects/\{bundlePid\}?relationship="http://purl.org/dspace/model/hasBitstream"&object=\{bitstreamPid\} /objects/\{bitstreamPid\} ? ... see [http://www.fedora-commons.org/documentation/3.0/userdocs/server/webservices/rest/index.html#addDatastream addDatastream] |
(b) Creates metadata properties attached to any of the above DSpace Objects.
Panelcode |
---|
/objects/{pid} ? relationship=http://purl.org/elements/1.1/title&object="My Title"&isLiteral=true |
addDatastream
URL Syntax
Panelcode |
---|
/objects/{pid}/datastreams/{dsID} ? [controlGroup] [dsLocation] [altIDs] [dsLabel] [versionable] [dsState] [formatURI] [checksumType] [checksum] [logMessage] |
--Mark Diggory 15:58, 12 July 2009 (EDT)
...