When you are using DDS and a have a user that has subscription permissions you cannot use the normal /order POST to create orders. Then you use this version which has a few modifications and additional validations to use in order to get access to watermarked content for your subscription customers.
Place an order for a subscription service
Before downloading the book for a customer you make an order, and based on that order you can use get content to download the file.
...
Authorization
...
The token acquired from the Authentication Service.
Formated "Boknett TGT-...."
...
firstname
...
First name of the person buying the book (Required for all books with SDRM)
...
Location
...
https://api.dds.boknett.no/content/{fulfilmentId}
...
Subscription reporting
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.
...
Authorization
...
The token acquired from the Authentication Service.
Formated "Boknett TGT-...."
...
Example (curl)
Successful reporting on a book that has reached the reading threshold
curl -i-H "Content-Type: application/json" -H "Authorization: Boknett TGT-20025-OIgkKTofLlCJQasKhiuigfGQ7p0PueBCBvp0IFkN7TeQ0lrdFS-login.boknett.no" -H "Date: Fri, 07 Aug 2015 12:54:00 GMT" -d '{"resid":"fab4599e-eb2e-445a-a7f9-4af12c052dec","dateTime":"2015-10-21"}' https://api.dds.boknett.no/usage/subscription/rvu
...
as a subscription service provider, you cannot access content based on a regular order. There are also some special requirements with regards to reporting. The API separates between two types of subscription services:
Child pages (Children Display) |
---|