Versions Compared

Key

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

...

Respective field info 
The list of the items containing related fields .
Response code details: 
204 - if there are no communities on the system
Fields supported (for element):
metadata - item metadata 
submitter - submitter group
isArchived - archival status of the item
isWithdrawn - states if the item is withdrawn
owningCollection - owning collection of the item
lastModified - last modified time
collections - collections the item appears in
communities - communities the item appears is
name - name of the item
bitstreams - bitstreams related to the  item
handle - item handle (unique identified)
canedit - states can user edit the item
id - item id 
type - element type
bundles - bundles related to the item
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="90a99cbb-c676-4d55-bd77-c550958df34d"><ac:plain-text-body><![CDATA[

Return a particular data field found in bitstream id.
Supported fields (for element):
mimeType -  mime type of file
bundles - bundles the bitstream is a part of
checkSum - checksum of the file
checkSumAlgorithm - checksum algorithm used
description - bitstream description
formatDescription - file format description
sequenceId - sequence id of the file
size - size of the file 
source - source (typically filename with path information)
storeNumber - asset store number where the bitstream is stored
userFormatDescription - user's format description
name - bitstream name
handle - unique id of the bitstream
id - internal id of the bitstream
type - type of the entity (referring to bitstream)
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="11d7cac6-b818-4325-908f-9d27197ba8de"><ac:plain-text-body><![CDATA[
Return a particular data field found in the group entity id.
Supported fields (for element):
handle - unique id (external)
id - internal id of the gruop
isEmpty - is the group empty
members - group members (as users)
memberGroups - group members (as groups)
name - group name
type - entity type (referring to group)
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="2a2289e9-91ac-46f8-b3ca-50be7e5bd4bd"><ac:plain-text-body><![CDATA[

C

Verb

URL

Description

Mandatory parameters

Optional parameters

Sorting fields

Response Data

Formats

Response codes

 

GET

/communities

Returns a list of all communities on the system or return just top level communities.

-

topLevelOnly=true
idOnly=false
detailsdetail=standard

id 
name
countitems

The list of communities containing respective fields .

Response code details:
204 - if there are no communities on the system

json
xml

200, 204, 400, 500

 

GET

/communities/{id}

Return detailed information about id community.

id

idOnly=false
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="20f0aab5-a659-4f7f-95a0-e906f03465af"><ac:plain-text-body><![CDATA[ {{[details=standard|#details]}} detail=standard

-

[Fields #com_elements] describing community.

json
xml

[200, 400, 404, 500

#rcodes]

]]></ac:plain-text-body></ac:structured-macro>

 

GET

/

 

GET

/communities/{id}/{element}

Return a particular data field found in the community id

Anchor
com_elements
com_elements
Fields supported (for element):
id - entity identifier, internal to the system
name - entity name
countItems - number of items under community
handle - handle of the community (unique persistent resource identifier)
type - entity type (object type in the system)
collections - collections contained in the community, ordered by id
canedit - states user persmission on the community (editing)
anchestor - anchestors of the community
children - subcommunities, ordered by id
administrators - group administrators, ordered by id
recent - recent items in the community
shortDescription - short description
copyrightText - copyright text
sidebarText - sidebar text
introductoryText - introductory text


id

idOnly=false  
immediateOnly=true
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="c85cc09c-2aea-48a2-91b7-041f8b15a14e"><ac:plain-text-body><![CDATA[ {{[details=standard|#details]}}

{{[id

#sort_id]}}
{{[name

#sort_name]}}
{{[countitems

#sort_countitems]}}

json
xml


detail=standard

id
name
countitems

Respective field info 

json
xml

200, 204, 400, 500

 

GET

/communities/{id}/logo

Return a community logo

id

-

-

Contains community logo (bitstream)

binary

200, 400

 

GET

/collections

Return a list of all collections in the system.

-

idOnly=false
isAuthorized=false
detail=standard

id 
name 
countitems

The list of the collections containing respective fields.

Response code details: 
204 - if there are no communities on the system

json
xml

[200, 204, 400, 500

#rcodes]

 

]]></ac:plain-text-body></ac:structured-macro>

 

GET

/communitiescollections/{id} /logo

Return a community logo

id

-

-

Contains community logo (bitstream)

binary

Return detailed information about id collection

id

idOnly=false
detail=standard

id
name
countitems

Fields of the collection entity.

json
xml

200, 204, 400, 500 200, 400

 

GET

/collections/{id}/{element}

Return a list of all collections particular data field found in the systemcollection id.

Anchor
col_elements
col_elements
Fields supported (for element):
id - entity identifier, internal to the system
name - collection name 
licence - collection licence
items - items contained in collection
handle - handle of the collection (unique persistent resource identifier)
canedit - states user permission on the collection (edit)
communities - communities collection is a part of
countItems - number of the items in the collection
type - entity type (object type in the system)
shortDescription - short description of the collection
introText - introductory text for the collection
copyrightText - copyright text for the collection
sidebarText - sidebar text for the collection
provenance - provenance

id

idOnly=false
immediateOnly=true
#immediateonly detail=standard

id 
name
countitems

Respective field info

json
xml

200, 204, 400, 500

 

GET

/items

Return a list of the items in the system

-

detail=standard

-

The list of the items containing related

-

idOnly=false
isAuthorized=false
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="02766164-88a9-412e-b5f6-eb4ff57ecd40"><ac:plain-text-body><![CDATA[ {{[details=standard|#details]}}

{{[id

#sort_id]}} 
]]></ac:plain-text-body></ac:structured-macro>
name 
countitems

The list of the collections containing respective fields .

Response code details: 
204 - if there are no communities on the system

json
xml

 

  200, 204, 400, 500

 

GET

/collectionsitems/{id}

Return detailed information about id collection an item.

id

idOnly=false
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="7c3daba2-78dc-49bf-a65c-fba9f87382df"><ac:plain-text-body><![CDATA[[details=standard|#details]

{{[id

#sort_id]}}
]]></ac:plain-text-body></ac:structured-macro>
name
countitems

Fields of the collection entity.

detail=standard

id 
name 
lastmodified
submitter

Fields of the item entity.

json 
json
xml

200, 204, 400, 500

 

GET

/collectionsitems/{id}/{element}

Return a particular data field found fould in the collection item id.

Anchor
colite_elementscol
ite_elements
Fields supported (for element):
id - entity identifier, internal to the system
name - collection name 
licence - collection licence
items - items contained in collection
handle - handle of the collection (unique persistent resource identifier)
canedit - states user permission on the collection (edit)
communities - communities collection is a part of
countItems - number of the items in the collection
type - entity type (object type in the system)
shortDescription - short description of the collection
introText - introductory text for the collection
copyrightText - copyright text for the collection
sidebarText - sidebar text for the collection
provenance - provenance

id

idOnly=false
immediateOnly=true
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="36271c4b-5d9f-4190-b348-9d850ded3ece"><ac:plain-text-body><![CDATA[{{[

#immediateonly]}} [details=standard|#details]

{{[id

#sort_id]}} 
]]></ac:plain-text-body></ac:structured-macro>
name
countitems

Respective field info

json
xml

200, 204, 400, 500

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="918018cd-6e2a-4883-97f6-f6887d5cd4f9"><ac:plain-text-body><![CDATA[

 

GET

/items

Return a list of the items in the system

-

[details=standard|#details]
]]></ac:plain-text-body></ac:structured-macro>

metadata - item metadata 
submitter - submitter group
isArchived - archival status of the item
isWithdrawn - states if the item is withdrawn
owningCollection - owning collection of the item
lastModified - last modified time
collections - collections the item appears in
communities - communities the item appears is
name - name of the item
bitstreams - bitstreams related to the  item
handle - item handle (unique identified)
canedit - states can user edit the item
id - item id 
type - element type
bundles - bundles related to the item

id, element

detail=standard

-

Respective field info

json
xml

200, 204, 400, 500

 

GET

/bitstream/{id}

Return bitstream object - usually the library item file.

id

-

-

Fields of the bitstream entity. 

json, xml

200, 400, 401, 403, 404, 500

 

GET

/bitstream/{id}/{element

Return a particular data field found in bitstream id.

Anchor
bit_elements
bit_elements

Supported fields (for element):
mimeType -  mime type of file
bundles - bundles the bitstream is a part of
checkSum - checksum of the file
checkSumAlgorithm - checksum algorithm used
description - bitstream description
formatDescription - file format description
sequenceId - sequence id of the file
size - size of the file 
source - source (typically filename with path information)
storeNumber - asset store number where the bitstream is stored
userFormatDescription - user's format description
name - bitstream name
handle - unique id of the bitstream
id - internal id of the bitstream
type - type of the entity (referring to bitstream)

id, element

detail=standard

-

Respective field info

json, xml

200, 400, 401, 403, 404, 500

 

GET

/bitstream/{id}/receive

Return bitstream

id

-

-

Return bitstream

binary

200, 400, 401, 403, 404, 500

 

GET

/groups

Return a list of the groups in the system

-

detail=standard

-

The list of the groups containing related fields .

204 if there are no groups in the system.

json,

-

 

 

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="638cd323-51e4-418d-925d-e64008a66799"><ac:plain-text-body><![CDATA[

 

GET

/items/{id}

Return detailed information about an item.

id

[details=standard|#details]

id 
]]></ac:plain-text-body></ac:structured-macro>
name 
lastmodified
submitter

Fields of the item entity.

json 
xml

200, 204, 400, 500

 

GET

/itemsgroups/{id} /{element}

Return a particular data field fould in the item id

Anchor
ite_elementsite_elements

id, element

[details=standard|#details]

-

Respective field info

json
]]></ac:plain-text-body></ac:structured-macro>
xml

200, 204, 400, 500

 

GET

/bitstream/{id}

Return bitstream object - usually the library item file.

id

-

-

Fields of the bitstream entity. 

json, xml

200, 400, 401, 403, 404, 500

 

GET

/bitstream/{id}/{element

Anchor
bit_elementsbit_elements

group object

id

detail=standard

-

Fields of the group entity.

json,xml

200, 204, 400, 500

 

GET

/groups/{id}/{element}

Return a particular data field found in the group entity id.

Anchor
gro_elements
gro_elements

Supported fields (for element):
handle - unique id (external)
id - internal id of the gruop
isEmpty - is the group empty
members - group members (as users)
memberGroups - group members (as groups)
name - group name
type - entity type (referring to group)

id, element

detail=standard

-

Respective field info

id, element

[details=standard|#details]

-

Respective field info

json, xml

200, 400, 401, 403, 404, 500

]]></ac:plain-text-body></ac:structured-macro>

 

GET

/bitstream/{id}/receive

Return bitstream

id

-

-

Return bitstream

binary

200, 400, 401, 403, 404, 500

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="d9f5f172-a775-42f9-ad5d-6bacb6adfda8"><ac:plain-text-body><![CDATA[

 

GET

/groups

Return a list of the groups in the system

-

[details=standard|#details]

-

The list of the groups containing related [fields

#gru_elements] .
]]></ac:plain-text-body></ac:structured-macro>
204 if there are no groups in the system.

json,xml

200, 204, 400, 500

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a0985af5-d723-4767-8630-e72deab8c51f"><ac:plain-text-body><![CDATA[

 

GET

/groups/{id}

Return a group object

id

[details=standard|#details]

-

[Fields

#gro_elements] of the group entity.

json,xml

200, 204, 400, 500

]]></ac:plain-text-body></ac:structured-macro>

 

GET

/groups/{id}/{element}

Anchor
gro_elementsgro_elements

id, element

[details=standard|#details]

-

Respective field info

json,xml

200, 204, 400, 500

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a94cfabe-6cb9-4723-9535-8b2ec9e1a26e"><ac:plain-text-body><![CDATA[

 

GET

/users

Return a list of the users in the system

-

[details=standard|#details]

-

The list of the users containing related [fields

#use_elements] .

json,xml

200, 204, 400, 500

 

GET

/users

Return a list of the users in the system

-

detail=standard

-

The list of the users containing related fields .

json,xml

200,204,400,500

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="192a9139-1e9b-4052-95db-14beb4390c3f"><ac:plain-text-body><![CDATA[

 

GET

/users/{id}

Return a user info

id

[detailsdetail=standard|#details]

-

[Fields#use_elements] of the user entity.

json,xml

200,204,400,500 ]]></ac:plain-text-body></ac:structured-macro>

 

GET

/users/{id}/{element}

Return a particular data field found in the user id.

Anchor
use_elements
use_elements

Supported fields (for element):
email - user's email
firstName - first name
fullName - full name
handle - handle (unique, external)
id - internal id of the user
language - preferred language
lastName - last name
name - name 
netId - network id
requireCertificate - requires certificate to login
selfRegistered - is user self registered
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="ecdf99e4-0df7-4f49-8360-550ef39ca1b5"><ac:plain-text-body><![CDATA[ type - type of the object

id,element

[detailsdetail=standard|#details]

-

Respective field info

json,xml

200,204,400,500 ]]></ac:plain-text-body></ac:structured-macro>

Note: modifier idOnly is referred only to first layer of the results. For all other layers (e.g. nested results) only ids are returned in some cases, due to possible loops. Example: for community containing collections,  on second level the response contains only ids for some elements where multiple loops may be created (community->has_collection->has_community....). Other data is modified according to idOnly flag.

...