Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

 


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 service is only for customers with subscription model using the revenue share financial model. When passing the agreed threshold for reading (i.e. 10%) the subscription provider should send a call this usage API reporting which book the threshold was met for. This can either be done in real time or on a batch basis, but reporting should at a minimum be done daily.

 

...

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 {resid} found in the Inventory service 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

  • Raw EPB file with no watermark

URL

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

Expand
titleLegacy

https://api.dds.boknett.no/

usage

content/

subscription/rvu
MethodPOSTRequest
headers

Authorization

Required

raw/{resid}

The token acquired from the Authentication Service.

Formated "

Example: Authorization: Boknett TGT-....

"Required

Request header Date


The timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT

Content-type

Method

Required

GET

application/jsonJSON attributesresidRequiredThe product ID in DDS. Unique name for e-/audio books found in the inventory service.dateTimeRequiredThe date the product passed the agreed threshold, given in ISO-8601 format. YYYY-MM-DDResponse
bodyEmpty on successReturns204Success40xOn errors

 

Example (curl)

 

Successful reporting on a book that has reached the reading threshold

 

...

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