/
OAI PMH

OAI PMH

From version 23.3 OAI-PMH is only available upon request

Introduction

  • OAI-PMH is an open standard designed for harvesting metadata

  • The full documentation can be found online

  • The complete API reference is also available

  • The OAI is from version 23.3 only available upon request.

OAI

Upon activation of the component you can access it using

https://<Your MediaHaven URL>/mediahaven-oai/oai

The Integration installation of MediaHaven always contains the latest release from MediaHaven

https://integration.mediahaven.com/mediahaven-oai/oai

Delete Support

From version 22.1 the engine now has delete support for OAI meaning

  • Logically deleted records are present in OAI responses

    • These records are marked with <header status="deleted"> as mandated by the OAI spec

  • When a record is logically deleted, the Administrative.LastModifiedDate changes and there will be a corresponding harvest for the corresponding date

Note that the OAI specification forbids including the metadata of a deleted record in the response, however you can still make a GET request using the https://mediahaven.atlassian.net/wiki/spaces/CS/pages/2447769640 2.0

Cookbook

Metadata formats

https://integration.mediahaven.com/mediahaven-oai/oai?verb=ListMetadataFormats

Metadata formats that include children will result in large XML files. These metadata formats are discouraged when requesting a list of records and should only be used when requesting a single record.

See https://mediahaven.atlassian.net/wiki/spaces/CS/pages/4701683731 for additional information.

Format

Description

Includes children from intellectual objects

https://mediahaven.atlassian.net/wiki/spaces/CS/pages/4486791184

Includes children from ensembles

Since

Format

Description

Includes children from intellectual objects

https://mediahaven.atlassian.net/wiki/spaces/CS/pages/4486791184

Includes children from ensembles

Since

oai_dc

A small subset of Dublin core made for OAI

 

 

 

mhs-head

The most recent https://mediahaven.atlassian.net/wiki/spaces/CS/pages/488964146

 

 

 

mhs

The https://mediahaven.atlassian.net/wiki/spaces/CS/pages/2015100971

 

 

 

mets-mhs-head

METS format with as embedded metadata the most recent https://mediahaven.atlassian.net/wiki/spaces/CS/pages/488964146

 

 

 

mets-mhs

METS format with as embedded metadata the https://mediahaven.atlassian.net/wiki/spaces/CS/pages/2015100971

 

 

 

mets

METS format with as embedded metadata the obsolete https://mediahaven.atlassian.net/wiki/spaces/CS/pages/722534416

 

 

mets-mhs-tree

METS format with as embedded metadata the https://mediahaven.atlassian.net/wiki/spaces/CS/pages/2015100971 and the inclusion of children.

25.1

mets-mhs-tree-head

METS format with as embedded metadata the most recent https://mediahaven.atlassian.net/wiki/spaces/CS/pages/488964146 and the inclusion of children.

25.1

Selective harvesting

Select harvesting is the most useful feature of OAI-PMH, allowing for querying the API for recent changes and for keeping another platform in sync with changes. Open Archives Initiative - Protocol for Metadata Harvesting - v.2.0 describes in “Selective harvesting” how to achieve this.

Get metadata

https://integration.mediahaven.com/mediahaven-oai/oai?verb=ListRecords&metadataPrefix=mhs-head

Query Parameter

Description

Example

Query Parameter

Description

Example

format

The metadata format as described in the previous section

mhs-head

from

Return records that have been modified after this date (inclusive)

2020-07-05

until

Return records that have been modified before this date (inclusive)

2020-07-06

resumptionToken

Use this token to receive additional records matching between the time interval [from,until]. See OAI Reference for more details.

e21ldGFkYXRhUHJlZml4PW1ocy1oZW...

(base 64 string)

The parameters from and until are calculated against the metadata field Administrative.LastModifiedDate. See https://mediahaven.atlassian.net/wiki/spaces/CS/pages/42074134 for the complete reference.

Authentication

  • From version 23.2 the basic authentication is deprecated and strongly discouraged from use because of security reasons

  • The standard https://mediahaven.atlassian.net/wiki/spaces/CS/pages/872251552 authentication must be used instead and is already available since at least 22.1

  • From version 25.1 the basic authentication support is removed