Versions Compared

Key

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

...

C

Verb

URL

Description

Mandatory parameters

Optional parameters

Sorting fields

Response Data

Formats

Response codes

 

GET

/search

Return a list of all objects found by searching criteria.
Notice: community and collection are mutually exclusive options.

-

TBD modifiers{{query=query}}&(community=id or
collection={{id}}
idOnly=false

id
name
lastmodified
submitter

Item info with basic metadata for the search results. Additionally return only
identifiers when idOnly=true is used.

json
xml

200, 204, 400, 500

 

GET

/harvest

Return a list of all objects that have been created, modified or withdrawn within specified time range.

-

startdate
{enddate}}
community
collection
idOnly=false
withdrawn=false
Notice: community and collection are mutually exclusive options

-

Contains item info including id, name, handle, metadata, bitstreams according to
the defined requirements. Additionally when idOnly=true only identifiers of
results are returned. If the date is in incompatible format, error 400 is returned.

json
xml

200, 204, 400, 500

Item manipulation

Info
titleNot completed!

To be rewritten and moved to repository manipulation

...

C

...

Verb

...

URL

...

Description

...

Mandatory parameters

...

Optional parameters

...

Response Data

...

Formats

...

Response codes

...

...

POST

...

/items/{id}/action

...

Change parameters of item id

...

id

...

createBundle
createSingleBitstream
removeLicenses
removeDspaceLicense
licenseGranted

...

Response code

...

json 
xml

...

200, 400, 401, 403, 500

...

 

...

PUT

...

/items/{id}

...

Change parameters of an item id

...

-

...

isArchived
isWithdrawn
owningCollection
submitter
owningCollection

...

 

...

 

...

 

...

 

...

PUT

...

/items/{id}/bundles/

...

Add an existing bundle bid to item id

...

id
bid

...

 

...

 

...

 

...

 

...

 

...

DELETE

...

/items/{id}/bundles/

...

Remove bundle bid from item id

...

id
bid

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

Set archival status of an item

...

id

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

 

...

PUT

...

/items/{id}/metadata

...

Add a single metadata field

...

 

...

 

...

 

...

 

...

 

...

DELETE

...

/items/{id}metadata

...

Remove a single metadata field

...

schema
element
qualifier
lang

...

 

...

 

...

 

...

 

...

 

...

DELETE

...

/items/{id}/metadata

...

 

...

 

...

 

...

 

...

 

...

 

...

...

POST

...

/communities

...

Add community to the system

...

name

...

logo 
parent 
other metadata

...

Id of newly created community

...

json 
xml

...

200, 400, 401, 403, 500

...

• 

...

DELETE

...

/communities/{id}{}

...

Delete community from the system

...

id

...

-

...

Response code

...

json 
xml

...

200, 400, 401, 403, 500

...

• 

...

PUT

...

/collections/{id}{}

...

Change description of id collection

...

id

...

 

...

Response code

...

json 
xml

...

200, 400, 401, 403, 500

...

• 

...

POST

...

/collections

...

Add collection to the system

...

name 
communityId

...

 

...

Id of newly created collection

...

json 
xml

...

200, 400, 401, 403, 500

...

• 

...

DELETE

...

/collections/{id}{}

...

Delete collection from the system

...

-

...

-

...

Response code

...

json 
xml

...

User oriented functions

C

Verb

URL

Description

Mandatory parameters

Optional parameters

Sorting fields

Response Data

Formats

Response codes

 

GET

/users

Return a list containing id, name and email of persons.

-

query
idOnly=false

id
name
lastname
fullname
language

List with information on particular user. Additionaly only identifiers are sent if idOnly is true.

json
xml

200, 204, 400, 500

Statistical info


C

Verb

URL

Description

Mandatory parameters

Optional parameters

Sorting fields

Response Data

Formats

Response codes

 

GET

/stats

Return general statistics.

-

-

-

Cummulative list of statistics data for the system currently available.

json
xml

200, 400, 500

...