DBC OAI Repo

DBC OAI Repo provides an interface to harvest metadata from DBC' Open Search data well. Data OAI Repo contains data from the raw repo, which means that the records are available in their original, raw form, and not consolidated. 

DBC OAI Repo is based on version 2.0 of the OAI-PHM standard. In the terminology of OAI-PMH, DBC OAI Repo is a data provider/repository. 

Endpoints

URLData repository versionEnvironment
https://oai.addi.dk/oai 3.5production
https://oss-services.dbc.dk/oai 3.5test

 

How to use DBC OAI Repo

DBC OAI Repo works as specified in the OAI-PHM Version 2.0 Specification.

Below are a list of examples that should serve as a quick introduction to the interface and possibilities of DBC OAI Repo.

Authentication

Some data sets require subscription and therefore authentication is required to obtain these. Authenticate by using the identity-parameter with the Netpunkt-triple (syntax: user:group:password) of your institution:

https://oss-services.dbc.dk/oai?verb=ListRecords&metadataPrefix=marcx&set=bkm&identity=netpunkt:100200:password

Pretty print:

Use indent=on for human readability:

https://oss-services.dbc.dk/oai?verb=GetRecord&identifier=870970:02428474&metadataPrefix=marcx&indent=on

Operations (OAI verbs):

Identify

Basic information about the repository:

https://oss-services.dbc.dk/oai?verb=Identify

ListSets

Information about available data sets in the repositories:

https://oss-services.dbc.dk/oai?verb=ListSets

ListMetaDataFormats

Available metadata formats:

https://oss-services.dbc.dk/oai?verb=ListMetadataFormats

The available format, marcx, refers to danMARC2 in MarcXchange 1.1 format.

ListRecords

This is the main function of DBC OAI Repo and is used to harvest records.

https://oss-services.dbc.dk/oai?verb=ListRecords&metadataPrefix=marcx

The metadataPrefix parameter is mandatory. Possible values are retrieved with ListMetadataFormats.

The parameters from and until can be used to define a date interval for the harvested records:

https://oss-services.dbc.dk/oai?verb=ListRecords&from=2017-05-01T14:15:00Z&until=2017-05-16T14:15:00Z&metadataPrefix=marcx

Specify a set (set names are retrieved using ListSets) using the parameter set. If no set name is specified, records from all available sets are retrieved.

https://oss-services.dbc.dk/oai?verb=ListRecords&metadataPrefix=marcx&set=nat

If further records are available within the defined set, a resumptionToken is returned. Call ListRecords with the token to retrieve the next records in the sets. Please note, that the resumptionToken must be URL-encoded when used in a request:

https://oss-services.dbc.dk/oai?verb=ListRecords&resumptionToken=%2BF77yj1eqsrmvfPQL8%2FX6%2FLyDPIs8%2F4%2F5DyABq2q91zV7PAJhq74gA%3D%3D

If the resumptionToken-element is empty, all records have been retrieved.

ListIdentifiers

To only retrieve identifiers but not actual records, use ListIdentifiers. Use and options are the same as for ListRecords.

https://oss-services.dbc.dk/oai?verb=ListIdentifiers&metadataPrefix=marcx

GetRecord

A specific record can be retrieved by it's identifier using getRecord:

https://oss-services.dbc.dk/oai?verb=GetRecord&identifier=870970:02428474&metadataPrefix=marcx