OpenPlatform

API for central functionality in the National Danish Library Infrastructure provided by Danish Digital Library (DDL) - in danish: Danskernes Digitale Bibliotek

This API is designed to ease access to basic functionality like

• searching for titles, autors, keywords
• getting borrower status
• renew existing loans
• placing or deleting holds
• get access to physical libraries (Address, opening hours …)

Table of Contents

• Access
• Releases
• Usage
• Terminology
• Contributing
• Credit
• Reference
• Contact

---

Access

The API is available on https://openplatform.dbc.dk/. A staging version is available on https://openplatform-stg.dbc.dk

These sites also include API-documentation.

Prerequisites

Access requires registration prior to issueing a Client id and Client secret. Only danish libraries can register projects and Client_id’s are only issued to a library or a partner via a library. In order for developers to access the Open Platform, they are pre-registered with a development project and a reference library This is required to protect the services and data contained in the data well.

Fill in the form to make an request for registration.

Releases

It is the entention that this platform shall be inproving constantly. The prospect is two major releases per year.

Version	URL	Environment	Release	End of life	Notes
4.0			To be announced	To be announced	Estimated 2019 Q1
3.0	https://openplatform.dbc.dk/v3/	Production	2018-05-15	To be announced	API changes v.2 to v.3
3.0	https://openplatform-stg.dbc.dk/v3/	Staging	2018-03	To be announced	API changes v.2 to v.3
2.0	https://openplatform.dbc.dk/v2/	Production	2017-09	2018-08-15	API changes v.1 to v.2 1
2.0	https://openplatform-stg.dbc.dk/v2/	Staging	2017-09	2018-08-15	API changes v.1 to v.2 1
1.0	https:\//openplatform.dbc.dk/v1/	Production	2016-07	2018-08-15	Deprecated

¹Changes in API structure from v.1 to v.2

NOTE

Always use the latest version of the API. Older versions will not be bugfixed.

Usage

Registered clients can authenticate themselves to recived an access token from the OAuth2 server. The authentification can include an Agency ID and a borrower id (+ pin code) to gain access to library / borrower specific data (opening hours, borrower status etc). Please refere to mapping login type with functionality for details.

With a valid access token the client can send request to the platform (See [https://openplatform.dbc.dk] for examples).

Examples on how to process data in requests an the returned data are provided in endpoints.

Terminology

1. General intro to the danish library univers
2. Library terminology
3. Library lingo - a simple bi-lingual list of library terminology (Danish/English)

Contributing

The endpoints in OpenPlatform are designed for generic use in relation to the National Library Infrastructure. No functionality that requires special local software or licences are included.

The software is delivered as-is. Any idears, suggestions or bugfixes are welcome (Please use the issue tracker)

Currently no modules related to local services are provided. But suggestions are welcome.

Credits

This API is developed by DBC A/S on behalf of the Danish Digital Library

Reference

Source code: https://github.com/DBCDK/serviceprovider

Contact

For further information please contact Erik Bachmann Pedersen, DDB.