Overview
OAI-PMH (https://www.openarchives.org/OAI/openarchivesprotocol.html) provides an application-independent interoperability framework based on metadata harvesting.
The LibraryCloud OAI-PMH Data Provider provides access to metadata about pre-defined sets of items in the Harvard Library collections. OAI "sets" are pre-defined and named as "collections" in the LibraryCloud collection database.
Metadata is provided in the MODS schema (http://www.loc.gov/standards/mods/) as extended in the Harvard LibraryCloud Schema (URL)
Base URI
https://api.lib.harvard.edu/oai
ListSets
The ListSets verb will return a list of all harvestable OAI sets defined as LibraryCloud Collections.
https://api.lib.harvard.edu/oai/?verb=ListSets
ListRecords
ListRecords requests the OAI data provider to return full metadata records for a given LibraryCloud Collection. Results can be returned as MODS or DC.
https://api.lib.harvard.edu/oai/?verb=ListRecords&metadataPrefix=mods&set=scores
https://api.lib.harvard.edu/oai/?verb=ListRecords&metadataPrefix=oai_dc&set=scores
ListIdentifiers
ListIdentifiers requests the OAI data provider to return the identifiers records for a given LibraryCloud Collection.
https://api.lib.harvard.edu/oai/?verb=ListIdentifiers&metadataPrefix=mods&set=CNAREVIEW (no matching records)
Identify
This verb is used to retrieve information about a repository.
https://api.lib.harvard.edu/oai/?verb=Identify (works)
GetRecord
This verb is used to retrieve an individual metadata record from a repository. Required arguments specify the identifier of the item from which the record is requested and the format of the metadata that should be included in the record.
https://api.lib.harvard.edu/oai/verb=GetRecord&metadataPrefix=oai_dc&identifier=oai:vc.harvard.edu:scarlet.000796856 (doesn't work)
https://api.lib.harvard.edu/oai/verb=GetRecord&metadataPrefix=oai_dc&identifier=oai:vc.harvard.edu:scarlet.990007968560203941 (alma vers doesn't work either)
ListMetadataFormats
xxx
This verb is used to retrieve the metadata formats available from a repository. An optional argument restricts the request to the formats available for a specific item.
https://api.lib.harvard.edu/oai/?verb=ListMetadataFormats (works)
https://api.lib.harvard.edu/oai/?verb=ListMetadataFormats&identifier=oai:vc.harvard.edu:scarlet.990007968560203941 (why doesn't this work?)