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}
...
Revenue share 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.
| URL | https://api.dds.boknett.no/usage/subscription/rvu | ||
| Method | POST | ||
| Request headers | Authorization | Required | The token acquired from the Authentication Service. Formated "Boknett TGT-...." |
| Date | Required | The timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT | |
| Content-type | Required | application/json | |
| JSON attributes | resid | Required | The product ID in DDS. Unique name for e-/audio books found in the inventory service. |
| dateTime | Required | The date the product passed the agreed threshold, given in ISO-8601 format. YYYY-MM-DD | |
| Response body | Empty on success | ||
| Returns | 204 | Success | |
| 40x | On errors | ||
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) |
|---|