Resources: By Author

Resources: By Author

This method lists the most recent resources authored by a specific author in XML format. The target expects to be passed a AUTHOR_NAME which can be determined from the Authors List method.

For example:

http://api.jorum.ac.uk/v0p3/resource/author/AUTHOR_NAME

This method takes the following optional parameters:

limit – a numeric value: when supplied the results returned will be limited to limit records, by default this value is 50.
starts_with – choose where in a results set to start displaying from. This takes a string as it’s value and matches against the start of resource titles, for example Jor.
order – choose how the results are alphabetically ordered, either asc or desc.

dc – when this parameter is set to true and the format requested is XML then the XML supplied with be formatted as Dublic Core metadata
Example Usage

http://api.jorum.ac.uk/v0p3/resource/author/jorum

Response Formats
The format of the response returned can be altered by adding a suffix to the request:

XML – [http://api.jorum.ac.uk/v0p3/resource/author/jorum.xml](http://api.jorum.ac.uk/v0p3/resource/author/jorum.xml)
JSON – [http://api.jorum.ac.uk/v0p3/resource/author/jorum.json](http://api.jorum.ac.uk/v0p3/resource/author/jorum.json)
RSS – [http://api.jorum.ac.uk/v0p3/resource/author/jorum.rss](http://api.jorum.ac.uk/v0p3/resource/author/jorum.rss)

and in the case of JSONP by supplying a callback function parameter:

JSONP – [http://api.jorum.ac.uk/v0p3/resource/author/jorum.jsonp?callback=myFunc](http://api.jorum.ac.uk/v0p3/resource/author/jorum.jsonp?callback=myFunc)

Sample Responses

XML
1 <?xml version="1.0" encoding="UTF-8"?>
 2 <resources>
 3     <total>6</total>
 4     <limit>50</limit>
 5     <sort>asc</sort>
 6     <offset>0</offset>
 7     <next_offset>-1</next_offset>
 8     <previous_offset>0</previous_offset>
 9     <resource_record>
10         <id>1282</id>
11         <title>Creating a profile in JorumOpen</title>
12         <description>This short video demonstrates how to create a profile in JorumOpen, the Jorum collection for open educational resources (OER). A profile is needed in order to deposit resources in JorumOpen. This is one of a series of vidcasts on using JorumOpen, including depositing and searching for resources. A suitable MP4 player is needed to view this video.</description>
13         <url>http://resources.jorum.ac.uk/xmlui/handle/123456789/1180</url>
14         <authors>
15             <author>Nicola Siminson</author>
16             <author>Jorum</author>
17         </authors>
18         <keywords>
19             <keyword>Jorum</keyword>
20             <keyword>JorumOpen</keyword>
21             <keyword>Open Educational Resources</keyword>
22             <keyword>OER</keyword>
23             <keyword>vidcast</keyword>
24             <keyword>video</keyword>
25         </keywords>
26         <rights>
27             <description>Attribution-Noncommercial-No Derivative Works 2.0 UK: England & Wales</description>
28             <url>http://creativecommons.org/licenses/by-nc-nd/2.0/uk/</url>
29         </rights>
30     </resource_record>
31     <resource_record>
32         <id>1284</id>
33         <title>Depositing files in JorumOpen</title>
34         <description>This short video demonstrates how to deposit files, such as documents, presentations, audio and video files into JorumOpen, the Jorum collection for Open Educational Resources (OER). A separate video is available on depositing web links. This is one of a series of vidcasts on using JorumOpen, including searching for resources. A suitable MP4 player is needed to view this video.</description>
35         <url>http://resources.jorum.ac.uk/xmlui/handle/123456789/1181</url>
36         <authors>
37             <author>Nicola Siminson</author>
38             <author>Jorum</author>
39         </authors>
40         <keywords>
41             <keyword>Jorum</keyword>
42             <keyword>JorumOpen</keyword>
43             <keyword>Open Educational Resources</keyword>
44             <keyword>OER</keyword>
45             <keyword>deposit</keyword>
46             <keyword>vidcast</keyword>
47             <keyword>video</keyword>
48         </keywords>
49         <rights>
50             <description>Attribution-Noncommercial-No Derivative Works 2.0 UK: England & Wales</description>
51             <url>http://creativecommons.org/licenses/by-nc-nd/2.0/uk/</url>
52         </rights>
53     </resource_record>
54     ...
55 </resources>
XML as Dublin Core
 1 <j:resources xmlns:j='http://vm-jorum-web.mimas.ac.uk/' 
 2              xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' 
 3              xsi:schemaLocation='http://vm-jorum-web.mimas.ac.uk/ http://api.jorum.ac.uk/v0p3/schemas/resources.xsd'>
 4     <total>6</total>
 5     <limit>50</limit>
 6     <sort>asc</sort>
 7     <offset>0</offset>
 8     <next_offset>-1</next_offset>
 9     <previous_offset>0</previous_offset>
10     <resource_record>
11         <id>1282</id>
12         <dc:title xmlns:dc='http://purl.org/dc/elements/1.1/'>Creating a profile in JorumOpen</dc:title>
13         <dc:description xmlns:dc='http://purl.org/dc/elements/1.1/'>This short video demonstrates how to create a profile in JorumOpen, the Jorum collection for open educational resources (OER). A profile is needed in order to deposit resources in JorumOpen. This is one of a series of vidcasts on using JorumOpen, including depositing and searching for resources. A suitable MP4 player is needed to view this video.</dc:description>
14         <dc:identifier xmlns:dc='http://purl.org/dc/elements/1.1/' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:type='dcterms:URI'>http://resources.jorum.ac.uk/xmlui/handle/123456789/1180</dc:identifier>
15         <dc:contributor xmlns:dc='http://purl.org/dc/elements/1.1/'>Nicola Siminson</dc:contributor>
16         <dc:contributor xmlns:dc='http://purl.org/dc/elements/1.1/'>Jorum</dc:contributor>
17         <dc:subject xmlns:dc='http://purl.org/dc/elements/1.1/'>Jorum</dc:subject>
18         <dc:subject xmlns:dc='http://purl.org/dc/elements/1.1/'>JorumOpen</dc:subject>
19         <dc:subject xmlns:dc='http://purl.org/dc/elements/1.1/'>Open Educational Resources</dc:subject>
20         <dc:subject xmlns:dc='http://purl.org/dc/elements/1.1/'>OER</dc:subject>
21         <dc:subject xmlns:dc='http://purl.org/dc/elements/1.1/'>vidcast</dc:subject>
22         <dc:subject xmlns:dc='http://purl.org/dc/elements/1.1/'>video</dc:subject>
23         <dc:rights xmlns:dc='http://purl.org/dc/elements/1.1/'>Attribution-Noncommercial-No Derivative Works 2.0 UK: England & Wales</dc:rights>
24         <dc:rights xmlns:dc='http://purl.org/dc/elements/1.1/' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:type='dcterms:URI'>http://creativecommons.org/licenses/by-nc-nd/2.0/uk/</dc:rights>
25     </resource_record>
26     <resource_record>
27         <id>1284</id>
28         <dc:title xmlns:dc='http://purl.org/dc/elements/1.1/'>Depositing files in JorumOpen</dc:title>
29         <dc:description xmlns:dc='http://purl.org/dc/elements/1.1/'>This short video demonstrates how to deposit files, such as documents, presentations, audio and video files into JorumOpen, the Jorum collection for Open Educational Resources (OER). A separate video is available on depositing web links. This is one of a series of vidcasts on using JorumOpen, including searching for resources. A suitable MP4 player is needed to view this video.</dc:description>
30         <dc:identifier xmlns:dc='http://purl.org/dc/elements/1.1/' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:type='dcterms:URI'>http://resources.jorum.ac.uk/xmlui/handle/123456789/1181</dc:identifier>
31         <dc:contributor xmlns:dc='http://purl.org/dc/elements/1.1/'>Nicola Siminson</dc:contributor>
32         <dc:contributor xmlns:dc='http://purl.org/dc/elements/1.1/'>Jorum</dc:contributor>
33         <dc:subject xmlns:dc='http://purl.org/dc/elements/1.1/'>Jorum</dc:subject>
34         <dc:subject xmlns:dc='http://purl.org/dc/elements/1.1/'>JorumOpen</dc:subject>
35         <dc:subject xmlns:dc='http://purl.org/dc/elements/1.1/'>Open Educational Resources</dc:subject>
36         <dc:subject xmlns:dc='http://purl.org/dc/elements/1.1/'>OER</dc:subject>
37         <dc:subject xmlns:dc='http://purl.org/dc/elements/1.1/'>deposit</dc:subject>
38         <dc:subject xmlns:dc='http://purl.org/dc/elements/1.1/'>vidcast</dc:subject>
39         <dc:subject xmlns:dc='http://purl.org/dc/elements/1.1/'>video</dc:subject>
40         <dc:rights xmlns:dc='http://purl.org/dc/elements/1.1/'>Attribution-Noncommercial-No Derivative Works 2.0 UK: England & Wales</dc:rights>
41         <dc:rights xmlns:dc='http://purl.org/dc/elements/1.1/' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:type='dcterms:URI'>http://creativecommons.org/licenses/by-nc-nd/2.0/uk/</dc:rights>
42     </resource_record>
43     ...
44 </j:resources>
JSON
 1 {
 2     "resources":[
 3     {
 4         "id":"1282",
 5         "title":"Creating a profile in JorumOpen",
 6         "description":"This short video demonstrates how to create a profile in JorumOpen, the Jorum collection for open educational resources (OER). A profile is needed in order to deposit resources in JorumOpen. This is one of a series of vidcasts on using JorumOpen, including depositing and searching for resources. A suitable MP4 player is needed to view this video.",
 7         "url":"http://resources.jorum.ac.uk/xmlui/handle/123456789/1180",
 8         "keywords":[
 9         {
10             "keyword":"Jorum" 
11         },
12         {
13             "keyword":"JorumOpen" 
14         },
15         {
16             "keyword":"Open Educational Resources" 
17         },
18         {
19             "keyword":"OER" 
20         },
21         {
22             "keyword":"vidcast" 
23         },
24         {
25             "keyword":"video" 
26         }
27         ],
28         "authors":[
29         {
30             "author":"Nicola Siminson" 
31         },
32         {
33             "author":"Jorum" 
34         }
35         ],
36         "rights":[
37         {
38             "rights_url":"http://creativecommons.org/licenses/by-nc-nd/2.0/uk/",
39             "rights_desc":"Attribution-Noncommercial-No Derivative Works 2.0 UK: England & Wales" 
40         }
41         ]
42     },
43     {
44         "id":"1284",
45         "title":"Depositing files in JorumOpen",
46         "description":"This short video demonstrates how to deposit files, such as documents, presentations, audio and video files into JorumOpen, the Jorum collection for Open Educational Resources (OER). A separate video is available on depositing web links. This is one of a series of vidcasts on using JorumOpen, including searching for resources. A suitable MP4 player is needed to view this video.",
47         "url":"http://resources.jorum.ac.uk/xmlui/handle/123456789/1181",
48         "keywords":[
49         {
50             "keyword":"Jorum" 
51         },
52         {
53             "keyword":"JorumOpen" 
54         },
55         {
56             "keyword":"Open Educational Resources" 
57         },
58         {
59             "keyword":"OER" 
60         },
61         {
62             "keyword":"deposit" 
63         },
64         {
65             "keyword":"vidcast" 
66         },
67         {
68             "keyword":"video" 
69         }
70         ],
71         "authors":[
72         {
73             "author":"Nicola Siminson" 
74         },
75         {
76             "author":"Jorum" 
77         }
78         ],
79         "rights":[
80         {
81             "rights_url":"http://creativecommons.org/licenses/by-nc-nd/2.0/uk/",
82             "rights_desc":"Attribution-Noncommercial-No Derivative Works 2.0 UK: England & Wales" 
83         }
84         ]
85     },
86     ...
87     {
88         "total":6,
89         "limit":50,
90         "order":"asc",
91         "offset":0,
92         "next_offset":1,
93         "previous_offset":0
94     }
95     ]
96 }
JSONP
 1 myFunc({
 2     "resources":[
 3     {
 4         "id":"1282",
 5         "title":"Creating a profile in JorumOpen",
 6         "description":"This short video demonstrates how to create a profile in JorumOpen, the Jorum collection for open educational resources (OER). A profile is needed in order to deposit resources in JorumOpen. This is one of a series of vidcasts on using JorumOpen, including depositing and searching for resources. A suitable MP4 player is needed to view this video.",
 7         "url":"http://resources.jorum.ac.uk/xmlui/handle/123456789/1180",
 8         "keywords":[
 9         {
10             "keyword":"Jorum" 
11         },
12         {
13             "keyword":"JorumOpen" 
14         },
15         {
16             "keyword":"Open Educational Resources" 
17         },
18         {
19             "keyword":"OER" 
20         },
21         {
22             "keyword":"vidcast" 
23         },
24         {
25             "keyword":"video" 
26         }
27         ],
28         "authors":[
29         {
30             "author":"Nicola Siminson" 
31         },
32         {
33             "author":"Jorum" 
34         }
35         ],
36         "rights":[
37         {
38             "rights_url":"http://creativecommons.org/licenses/by-nc-nd/2.0/uk/",
39             "rights_desc":"Attribution-Noncommercial-No Derivative Works 2.0 UK: England & Wales" 
40         }
41         ]
42     },
43     {
44         "id":"1284",
45         "title":"Depositing files in JorumOpen",
46         "description":"This short video demonstrates how to deposit files, such as documents, presentations, audio and video files into JorumOpen, the Jorum collection for Open Educational Resources (OER). A separate video is available on depositing web links. This is one of a series of vidcasts on using JorumOpen, including searching for resources. A suitable MP4 player is needed to view this video.",
47         "url":"http://resources.jorum.ac.uk/xmlui/handle/123456789/1181",
48         "keywords":[
49         {
50             "keyword":"Jorum" 
51         },
52         {
53             "keyword":"JorumOpen" 
54         },
55         {
56             "keyword":"Open Educational Resources" 
57         },
58         {
59             "keyword":"OER" 
60         },
61         {
62             "keyword":"deposit" 
63         },
64         {
65             "keyword":"vidcast" 
66         },
67         {
68             "keyword":"video" 
69         }
70         ],
71         "authors":[
72         {
73             "author":"Nicola Siminson" 
74         },
75         {
76             "author":"Jorum" 
77         }
78         ],
79         "rights":[
80         {
81             "rights_url":"http://creativecommons.org/licenses/by-nc-nd/2.0/uk/",
82             "rights_desc":"Attribution-Noncommercial-No Derivative Works 2.0 UK: England & Wales" 
83         }
84         ]
85     },
86     ...
87     {
88         "total":6,
89         "limit":50,
90         "order":"asc",
91         "offset":0,
92         "next_offset":1,
93         "previous_offset":0
94     }
95     ]
96 })
RSS
1 <?xml version="1.0" encoding="UTF-8"?>
 2 <rss xmlns:content="http://purl.org/rss/1.0/modules/content/" 
 3      xmlns:taxo="http://purl.org/rss/1.0/modules/taxonomy/" 
 4      xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" 
 5      xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" 
 6      xmlns:dc="http://purl.org/dc/elements/1.1/" version="2.0">
 7     <channel>
 8         <title>Resources Feed</title>
 9         <link>http://api.jorum.ac.uk/v0p3/resource/author/jorum.rss</link>
10         <description>A sample RSS feed for resources in a DSpace Collection</description>
11         <item>
12             <title>Creating a profile in JorumOpen</title>
13             <link>http://resources.jorum.ac.uk/xmlui/handle/123456789/1180</link>
14             <content:encoded>This short video demonstrates how to create a profile in JorumOpen, the Jorum collection for open educational resources (OER). A profile is needed in order to deposit resources in JorumOpen. This is one of a series of vidcasts on using JorumOpen, including depositing and searching for resources. A suitable MP4 player is needed to view this video.</content:encoded>
15             <guid>http://resources.jorum.ac.uk/xmlui/handle/123456789/1180</guid>
16         </item>
17         <item>
18             <title>Depositing files in JorumOpen</title>
19             <link>http://resources.jorum.ac.uk/xmlui/handle/123456789/1181</link>
20             <content:encoded>This short video demonstrates how to deposit files, such as documents, presentations, audio and video files into JorumOpen, the Jorum collection for Open Educational Resources (OER). A separate video is available on depositing web links. This is one of a series of vidcasts on using JorumOpen, including searching for resources. A suitable MP4 player is needed to view this video.</content:encoded>
21             <guid>http://resources.jorum.ac.uk/xmlui/handle/123456789/1181</guid>
22         </item>
23         ...
24     </channel>
25 </rss>

Response Breakdown
total The total number of results found by the method request.
limit The total number of resources returned by the request.
sort The method of sorting of the resource title (asc or desc) to be applied to the result request.
offset The value of offset required to display the current resources returned in a result set comprising the total number of results for the request.
next_offset The value of offset required to supply to a subsequent request to return the previous page of results in the results set.
previous_offset The value of offset required to supply to a subsequent request to return the next page of results in the results set.
id The unique DSpace identifier for the resource item.
title The title of the resource item as displayed in the DSpace UI. This element maps to the DSpace’s Qualified Dublin Core dc.title element.
description The description of the resource item as displayed in the DSpace UI. This element maps to the DSpace’s Qualified Dublin Core dc.description element.
url The full url for the resource item in DSpace.
keywords A block of elements containing keyword elements.
keyword A keyword associate with a resource item as displayed in the DSpace UI. This element maps to the DSpace’s Qualified Dublin Core dc.subject element. This element may occur 0 or more times.
author A block of elements containing author elements.
author An author of a resource item as displayed in the DSpace UI. This element maps to the DSpace’s Qualified Dublin Core dc.creator element. This element may occur 0 or more times.
rights A block of elements containing usage rights information for a resource item.
description The description of a resource items usage rights as displayed in the DSpace UI. This element maps to the DSpace’s Qualified Dublin Core dc.rights.description element.
url The URL pointing to the usage rights of a resource item as displayed in the DSpace UI. This element maps to the DSpace’s Qualified Dublin Core dc.rights.url element.