* This API will replace the current file-based deliverables of book metadata to Bogportalen.
* First priority is to onboard existing customers to the API. After the launch of the new Bogportalen platform, the Api will be opened up for new customers.
* Existing customers will contacted directtly regarding login details
Postman collection
To get a quick start with the API, a Postman collection has been created, with examples of autentifikation and the different JSON body options.
To use the collection:
- Insert “https://dbk-dw10.ditnyewebsite.dk” as baseUrl in the collection Variables
- Insert your username and password for the API, provided by DBK in the collection variables, and run the “Get API token” request in the collection
- Insert the token from the request in the collection variables.
- You’re now ready to send data to DBK
1. Overview
Purpose: Integration to send product metadata to Bogportalen.
Production endpoints:
Authentication: TBA
Data import request: TBA
Sandbox endpoints:
Authentication: https://dbk-dw10.ditnyewebsite.dk/dwapi/users/authenticate
Data import request: https://dbk-dw10.ditnyewebsite.dk/onix/document/import/v3.1/file
Formats: xml in onix format; charset=utf-8 (requests & responses). See Onix format for data to DBK here.
2) Authentication & Authorization
Use DW authentication endpoint: https://dbk-dw10.ditnyewebsite.dk/dwapi/users/authenticate
Post the following JSON object to the endpoint:
{
"username": "string",
"password": "string"
}
The returned bearer token is used as authorization header in the export requests to the endpoint.
3) Status codes and errors
Status codes:
- 200: OK
- 204: Request OK, but no content. Could be due to filters that provides no results
- 401: Unauthorized. Publisher Id in request does not match current logged in publisher
- 5xx server error
The list of error codes will be further extended when the sandbox version of the API is ready.
Example on error body:
{
"type":"https://tools.ietf.org/html/rfc9110#section-15.5.2",
"title":"Publisher Id in request does not match current logged in publisher",
"status":401,
"detail":"To request an onix output please request the same Publisher ID as the currently logged in publisher",
"traceId":"00-5d607d7dc612f1adfc7cae47189f8035-b3feb12c115e9d8e-00"
}4) Limits & Quotas
Policy:
- Up to 2.000 products can be sent in a request
5) SLs & Status
Uptime target: 99.9% monthly.
Maintenance windows: Announced 7 days ahead (non-critical).
Status page: Public status + historical incidents. · Support: FAQ/Support page on dbk.dk. Email + ticketing portal, business hours CET/CEST.
Version history
| Date | Version | Comment |
|---|---|---|
|
13-1-2026 |
3.1 |
First version of the API in sandbox mode. Please notice that there might be minor changes to this before it goes into production |