/
Partner models

Partner models


This page describes API endpoint for customers with partner models e.g. subscription model with revenue share or other models where you have access to download books from DDS without executing transactions first. All of these APIs require special commercial agreements with Bokbasen and special access rights. If you are building a standard sale-by-item book store you can safely ignore this page.

Get raw content

This endpoint gives access to raw files and is used if you have a model where your business yourself i storing, securing and distributing the files. The process for downloading is the same as for Content download, so only this initial step is different. You need to use the “ProductIdentifier” of type “36” found in Onix (see Migration Guide: Inventory API is shutting down) to start the download.

This will deliver either:

  • Single MP3 file in the best available quality (watermarked with your business' id)

  • Raw EPUB files with no watermark

URL

https://api.bokbasen.io/dds/content/v1/raw/{resourceId}

Method

GET

Request
headers

Authorization

Required

See Authentication Service

Audience: https://api.bokbasen.io/dds/

Accept

Required

application/json (We recommend all new implementations to use this header, XML support will be phased out in the future)

Response
headers

Location

https://api.dds.boknett.no/download/{downloadid}/status

Response
body

None

Returns

302

Found (on success, you will receive this code and a redirection to the resource download status page)

300

Multiple Choices

 

When is a product available for download?

Streamer

  • If the book has an embargodate, the content is available for download 24 hours before the embargodate

  • If the SalesRestriction for streaming for your company has a start date, the content will be avaiable 24 hours before the start date occurs.

Webshop

  • If the book has an embargodate, the content is available for download 24 hours before the embargodate