...
This document describes how to integrate with the Digital Distribution System (DDS) Application Programming Interface (API) through the use of web services. The resources that are available through the API AP0I spans from product information, placing orders to cloud storage. The API is suitable for stores, subscription services, libraries and publishers. For technical documentation on each API please refer to the online documentation which is frequently update: https://bokbasen.jira.com/wiki/display/api/Digital+Distribution+System
...
HTTPS based download of MP3
HTTPS based progressive downloads using HTTP range headers
HTTPS based download of zipped MP3 files split into smaller files
Apple HTTP Streaming (HLS) of MP3
Bokbasen supports the following e-book formats:
EPUB 2
EPUB 3
PDF (1.6 or newer)
EBP (E-book plus which is a proprietary HTML5 based format packed in a zip)
The process for getting the download link is the same for all formats, but you need to implement support for the specific formats in your reader/player.
About the format EBP
This format can only be downloaded to and read in custom made apps.
The store has the following possibilities; to create an app that supports the format, to inform the customer about the apps on the market that support the format or not offer these e-books at all.
The format is not delivered with DRM. Any copy protection mechanisms must be built into the app.
Metadata for e-/audio books
Metadata about e-/audio books are delivered as a separate service. Bokbasen delivers metadata about all types of books. You can read about formats and how to import and implement metadata to your site in the documentation for metadata services.
Established customers can contact us to start the delivery of metadata for e-/audio books in the same stream as received today.
Overview of the sales process
...
Metadata for e-/audio books
Metadata about e-/audio books are delivered as a separate service. Bokbasen delivers metadata about all types of books. You can read about formats and how to import and implement metadata to your site in the documentation for metadata services.
Established customers can contact us to start the delivery of metadata for e-/audio books in the same stream as received today.
Overview of the sales process
DDS INVENTORY
Services for e-/audio book inventory and basic metadata
Update and populate your system with data from the inventory service and the Bokbasen Metadata export API.
IMPORTANT! First update your system with the required metadata from the API. This is not a part of the e-/audio book distribution; it's a separate service.
DDS IDM
Services for user creation and management
Create user accounts for your customers and get the DDS ID for everyone by using the IDM services.
DDS E-/AUDIO BOOK ORDER AND DOWNLOAD
Services for e-/audio book inventory and basic metadata
Update and populate your system with data from the inventory service and the Bokbasen Metadata export API.
IMPORTANT! First update your system with the required metadata from the API. This is not a part of the e-/audio book distribution; it's a separate service.
DDS IDM
Services for user creation and management
Create user accounts for your customers and get the DDS ID for everyone by using the IDM services.
DDS E-/AUDIO BOOK ORDER AND DOWNLOAD
Services for e-/audio book order placements and file downloads/streaming
Create orders for your customers using order and download the file by using the get content REST API.
DDS BOKSKYA E-/AUDIO BOOK FEED
Services for fetching the users Bokskya feed with all purchased books
Get all the books that any of your customers have in their Bokskya e-/audio book feed. Feed contains links to download REST order placements and file downloads/streaming
Create orders for your customers using order and download the file by using the get content REST API.
DDS BOKSKYA E-/AUDIO BOOK FEED
Services for fetching the users Bokskya feed with all purchased books
Get all the books that any of your customers have in their Bokskya e-/audio book feed. Feed contains links to download REST APIs.
Use of metadata for an e-/audio book
...
All files that are marked with SDRM (Social DRM) in the inventory service will be watermarked individually per transaction when the file is delivered through the get content API. Watermarking provides a social layer of security, where it is always possible to determine which transaction a file was bought if it is shared in a way not conforming to the licensing.
Although they serve the same purpose, technically watermarking is quite different for audio- and e-books.
For audio books Bokbasen use an external party to implement watermarks. http://AudioLock.NET Ltd has an algorithm for watermarking that is a 'strict watermarking' technique which means that the watermark cannot be detected or decoded without the original audio.
This method provides the most robust technique while remaining inaudible. Rather than using specific frequencies to try to hide an additional signal the watermark uses temporal changes to the signal along with error correction to embed a payload. The watermark is robust and will survive repeated transcoding into different formats and bitrates. The watermark is repeated throughout the audio which means that the watermark can be found and decoded even with only short sections of the sound. No personal information about the transaction or buyer is stored in the filein the inventory service will be watermarked individually per transaction when the file is delivered through the get content API. Watermarking provides a social layer of security, where it is always possible to determine which transaction a file was bought if it is shared in a way not conforming to the licensing.
Ebooks
For ebooks, the watermark is a visible mark in the book where one can see the name provided displayed in a separate page of the book.
...