The HMS Challenger Collection is available to service providers interested in harvesting descriptive metadata via the OAI-PMH protocol.

For details on the OAI-PMH protocol please refer to the official documentation at http://www.openarchives.org/OAI/openarchivesprotocol.html.

Metadata is exposed by the OAI-PMH by sending requests to the repository. Metadata is returned as XML over HTTPS.

Protocol Requests


To get metadata from the repository, use the following requests, or verbs as defined in the OAI-PMH by adding them to the end of the base URL.

The base URL for the OAI-PMH is https://www.hmschallenger.net/oai.


Verbs


Identify

Example: https://www.hmschallenger.net/oai?verb=Identify
Use this verb to get basic technical information about the repository.

ListMetadataFormats

Example: https://www.hmschallenger.net/oai?verb=ListMetadataFormats
Use this verb to get a list of all the metadata formats available from the repository. The HMS Challenger OAI-PMH supports the oai_dc format. Oai_dc is a Dublic Core metadata schema providing baseline interoperability.

ListSets

Example: https://www.hmschallenger.net/oai?verb=ListSets
Use this verb to retrieve the sets of a repository. The HMS Challenger OAI-PMH only supports one set named Objects.

ListIdentifiers

Example: https://www.hmschallenger.net/oai?verb=ListIdentifiers&metadataPrefix=oai_dc&set=objects
This verb is an abbreviated form of ListRecords, retrieving only headers rather than records.

ListRecords

Example: https://www.hmschallenger.net/oai?verb=ListRecords&metadataPrefix=oai_dc&set=objects
Use this verb to retrieve records from the repository.

GetRecord

Example: https://www.hmschallenger.net/oai?verb=GetRecord&metadataPrefix=oai_dc&identifier=oai:www.hmschallenger.net:record/O4727

Use this verb to retrieve an individual record from the repository. A required argument for this verb is identifier, that specifies a unique identifier of a record in the repository.


Guide to fields in the Records


identifier

A unique identifier identifying the record in the repository.


datestamp

The date this record was created for selective harvesting.


dc:identifier

URL identifying the record.


dc:title

Simple name.


dc:description

Brief description.


dc:subject

Collection class.


dc:type

Form.


dc:rights

Licence.


dc:creator

Holding Insitituion.


dc:contributor

Holding Insitituion.


dc:publisher

Holding Insitituion.


dc:date

Date collected.