...
All users need to have a contract with Bokbasen before integration can start. Once the contract is signed each user is assigned a distributor ID and password that is used in all communication with DDS. It is important to note that metadata and e-/audio book distribution is two separate services, which work in companion. A separate contract concerning metadata is necessary. Bookstores, which already have a contract, do not need to renew this. Contact us to start the delivery of metadata for e-/audio books in the same stream as you get today.
...
Import the metadata updates from Bokbasen metadata API (all books available so you need to filter based on the data to load only the desired books, audio, e-book , EBP etc.)
Make a query to DDS Inventory REST API
Display metadata for all e-/audio books with published status = true combined with
access = true
The store should be able to display metadata of an e-book not published but with
a published excerpt. Important not to sell the e-book by accident. Note that for audio books the feed will never give an excerpt. Audio book excerpts are only available through Bokbasen metadata download object API.The store should be able to display metadata of an e-/audiobook for presales. Important to log the orders, but you cannot initiate downloads before the e-/audio book is published.
...
The JSON response will give you all available combinations of type and bitrate for the resource you requested and you can use that information to either resend the request with valid values or present this information to the user in a GUI to assure you are presenting options that are available.
<Lenke til confluence dokumentasjon her>
Order Response Codes and Errors
...
Services for fetching the users Bokskya feed with all purchased books
<Lenke til confluence dokumentasjon her>Bookshelf / OPDS
Last-Modified and If-Modified-Since Headers
...
Every bookstore gets an FTP account dedicated for reporting FTP login is DDS Customer ID (look below)<MÅ oppdateres?>
Frequency
Reports are generated once a day. At 06:00 AM at the latest in the morning and put on DDS FTP Server. The report always contains all orders from the day before from 00:00:00 to 24:00:00.<Må oppdateres?>
Packing of reports
All reports generated are merged per customer per day. The files are placed in a zip file which contains an index. If there is nothing to report for one day the zip file will contain only the index file.
...
The reports are delivered in EDItX Sales Report 1.0 format. The complete format standard can be found here http://www.editeur.org/ . The fields used for reporting e-/audio book sales are shown below with explanation.
<Lenke til confluence side med dokumentasjon her?>Orders and reporting
Security
Bokbasen services can only be accessed over HTTPS
It is the customer’s (using the API) responsibility to ensure safe storage of username and
password to Bokbasen services
All calls from one partner should use a proxy when accessing these services and IP
restrictions may be implemented
...