Jisc MediaHub Machine-to-Machine Interfaces

Terms of Use of metadata disseminated by the Jisc MediaHub machine-to-machine interfaces

Your use of metadata from MediaHub is subject to a Creative Commons Attribution licence version 3.0 unported (CC-BY 3.0). You should express attribution by reproducing the text from the mhub:credit element.

The Jisc MediaHub machine-to-machine interfaces are currently provided for testing only. Metadata may be retrieved for the purposes of developing and testing client software. No metadata may be distributed via another online resource base or publicly accessible web site. Subject to these terms, access to these interfaces available free of charge; please contact edina@ed.ac.uk.

Note: Metadata records from all collections hosted by Jisc MediaHub can be retrieved via these interfaces. Jisc MediaHub also contains metadata records from collections hosted on other web sites; the owners of a small number of these collections have opted not to make their records available via these interfaces.

SRU Interface

OAI-PMH Interface

Record format

Linking to Jisc MediaHub

---

SRU Interface

This interface is a beta. Please report any problems to edina@ed.ac.uk

Base URL:	http://m2m.edina.ac.uk/sru/
Port:	80
Database Name:	mediahub
Authentication	No authentication required
Supported Operations	explain, searchRetrieve
Supported Parameters	explain operation, version searchRetrieve operation, version, query, startRecord, maximumRecords
Indexes	cql.serverChoice The default index; this will be searched if your CQL query specifies no index. This is equivalent to the basic search in the Jisc MediaHub user interface, and is recommended unless you have a specific requirement for one of the other indexes. dc.title Record title. Searches only title text of records. dc.subject Record subject. Searches only subjects of records. mhub.collection Collection identifier. Each record returned contains the identifier of the host collection; this value can be used with a query of the mhub.collection index to retrieve all other records in that collection. dc.identifier Record identifier. May be used to retrieve a record from its identifier. dc.date Temporal coverage. Dates should be specified in YYYYMMDD format; month and day are optional. A range can be specified as YYYYMMDD..YYYYMMDD. For example dc.date=1990..1995 would retrieve all records with a date between 1 January 1990 and 31 December 1995. The temporal coverage of a record may itself be a date range, in which case any overlap between the query date range and the record date range is considered a match: for example a record with a range of 1988..1991 would match the query dc.date=1990..1995.

OAI-PMH Interface

This interface is a beta. Please report any problems to edina@ed.ac.uk

Base URL:	http://m2m.edina.ac.uk/oai/mediahub/
Version:	2.0
Metadata formats:	oai_dc Pure Dublin Core metadata. Providing this is mandatory under OAI-PMH but we strongly advise the use of the oai_mhub format instead. oai_mhub The preferred Jisc MediaHub record format.
Sets:	jisc-licensed Records describing video, image or audio covered by the Jisc eCollections licence. These resources may be viewed and downloaded by members of colleges or universities that subscribe to the Jisc eCollections service. For usage queries see the Terms of Service. inside-mediahub Records describing video, image or audio that are held at Jisc MediaHub. Users can view and download these resources directly from the Jisc MediaHub website provided they have logged in (if required). no-login Records describing video, image or audio that do not require a log in. These resources may be viewed and downloaded without a subscription. They may be held at Jisc MediaHub or on an external web site. For more details see http://jiscmediahub.ac.uk/about

Record format

Jisc MediaHub records are returned as XML. This record format is used by both the SRU and OAI-PMH interfaces. This uses Dublin Core elements plus additional MediaHub elements for metadata that cannot be adequately described by Dublin Core. The MediaHub elements use the namespace http://m2m.edina.ac.uk/ns/mediahub, prefix mhub.

All the elements listed below are children of the record container element mhub:record

Element	Repeatable	Optional	Description
dc:identifier	no	no	The record identifier.
mhub:relevancy-score	no	yes (never included in OAI-PMH responses)	A relevancy score. This is used for ranking the results. The value depends on how well the metadata for the record match the search term, and may be expected to be comparable within each result set but we do not recommend comparing results from different searches. EDINA may tweak the relevancy ranking algorithm from time to time, so a relevancy score retrieved at one time may differ from that retrieved at a later date, even for the same search.
mhub:collection-jisc-licensed	no	no	Flag indicating if the item described by this record is covered by the Jisc eCollections licence. Video, image or audio covered by this licence may be downloaded by memebers of colleges or universities that subscribe to the JISC eCollections service. For full details see the Terms of Service. true or false
mhub:collection-needs-login	no	no	Flag indicating if users must log in to view or download the video, image or audio described by this record. When this flag does not apply, the content is openly available, but users musy still abide by the terms of use. For full details see the Terms of Service. true or false
mhub:collection-is-external	no	no	Flag indicating if the collection is hosted on an external web site. Video, image or audio covered by this licence must be downloaded from the external site; Jisc MediaHub will refer users to the appropriate web page. For more information see the list of collections. true or false
dc:relation [@xsi:type="dcterms:URI"]	yes	yes	A URL for the web site of the original collection to which the item belongs.
dc:type [@xsi:type="dcterms:DCMIType"]	no	no	The DCMI Type of the item.
dcterms:extent [@xsi:type="xsd:duration"]	yes	yes	The duration of a video or audio item expressed as an XSD duration
mhub:duration-in-seconds	yes	yes	The duration in seconds of a video or audio item.
dc:title	no	no	The title of the item
dc:description	no	no	The description of the item. May contain simple HTML tags such as <p> (though always escaped). Deleting any tags should provide perfectly usable unstructured text.
mhub:link-to-mediahub [@xsi:type="dcterms:URI"]	no	no	A persistent URL that may be used to view the item record within Jisc MediaHub.
mhub:thumbnail-url [@xsi:type="dcterms:URI"]	yes	yes	The URL of a thumbnail image for the item.
dc:created [@xsi:type="xsd:date"]	yes	yes	The date the item was created. Note this may refer to a particular representation of an original item; for example, for a digitized photograph, this may be the date of digitization rather than the date of the photograph. For most purposes, mhub:temporal-coverage is likely to be preferable to dc:created.
mhub:credit	yes	yes	The person(s) and/or organization(s) who must be credited when an item is displayed.
mhub:rights	yes	yes	A rights statement for the item.
dc:contributor	yes	yes	These describe person(s) or organization(s) who had some role in the creation or provision of the item (either the original; a respresentation of it, such as a digitized version; or a process or service by which the item has been made available). The contents of these elements are poorly defined because of variability in the original metadata acquired by Jisc MediaHub, and inconsistencies in the original cataloguing. As far as is possible, dc:creator is used when the role was creative; dc:publisher when the role was publishing or otherwise providing an item; and dc:contributor when the specific role is not defined at all. You cannot display this information with any implication that it is a definitive description of the role played by any person or organization.
dc:creator
dc:publisher
dc:subject	yes	yes	A subject term for the item.
dc:coverage [@xsi:type="dcterms:Point"]	yes	yes	The geographic location of the subject of the item, expressed in DCMI Point notation.
mhub:geo-location	yes	yes	The geographic location of the subject of the item. Differs from dc:coverage by using a more usefully named container with child elements for geographic data, rather than the delimited text notation employed by DCMI Point. This element may contain zero or more of the following elements: north, east, name, elevation, units, zunits and projection. The contents of these elements are defined to be the same as those of components of the same name in DCMI Point.
dc:coverage [@xsi:type="dcterms:Period"]	yes	yes	The temporal coverage (date, date range or a named event/period in time) of the subject of the item, expressed in DCMI Period notation. At the present time only the start, end, and name components are used.
mhub:temporal-coverage	yes	yes	The temporal coverage (date, date range or a named event/period in time) of the item. Differs from dc:coverage by using a more usefully named container with child elements for temporal data, rather than the delimited text notation employed by DCMI Period. This element may contain zero or more of the following elements: start, end, scheme and name. The contents of these elements are defined to be the same as those of components of the same name in DCMI Period.

Linking to Jisc MediaHub

The mhub:link-to-metadata element provides a link to view the record in the web interface. For example:

http://jiscmediahub.ac.uk/record/display/022-01861640