Autumn 2016 Bokbasen will start delivering e-books from international publishers through DDS, to support the large increase in number of books and specific requirements from International publishers this requires some changes in the DDS integration. These changes are only required by stores that wants to sell books from these publishers, no changes needed if you are only selling books from Norwegian publishers.
Two end-points are changing and will work in parallell
All of these end-points are under development, and minor changes might occur but expected to be minimal.
Get inventory
The interface for inventory will change in order to support a larger volume of books with introducing a paging mechanism where you are sure that you are always getting books that have changes. (similar to the mechanism used in Metadata Export Service.
| URL | https://api.dds.boknett.no/v2/inventory/ https://api.dds.boknett.no/v2/inventory/{isbn} https://api.dds.boknett.no/v2/inventory/{resourceId} | ||
| Method | GET | ||
| 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 | |
| Query parameters | after | Optional | UUID (also called resId) of the ebook that you want information about, use this parameter only if you want detailed information about one single title. |
| next | Optional | Same as id only based on isbn to give information about a specific title (will always reply with data on latest version of digital book for the isbn) | |
| Response headers
| Content-Type | application/atom+xml;charset=UTF-8 | |
| Response body | ATOM Inventory XML format (same format as before) | ||
| Returns | 200 | OK | |
| 40x | On error | ||
Place an order
International books requires additional fields for order
| URL | https://api.dds.boknett.no/order | ||
| 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 | |
| Accept | Required | application/json (We recommend all new implementations to use this header, XML support will be phased out in the future) | |
| Content-type | Required | application/json | |
| JSON attributes | orderid | Required | Your store order ID. Used as transaction ID in DDS. Must be unique for a purchase. |
| resid | Required | The product ID in DDS. Unique name for e-/audio books found in the inventory service. | |
| spd | Required | Price in Norwegian "øre" (sold for) including VAT. Example NOK 189 = 18900 | |
| id | Optional | DDS-ID for end-consumer | |
firstname | Optional* | First name of the person buying the book (Required for all books with SDRM, minimum length 2) | |
| lastname | Optional* | First name of the person buying the book (Required for all books with SDRM, minimum length 2) | |
| excerpt | Optional | Order is for excerpt instead of actual book (defaults to false) | |
| Response headers
| Location | ||
| Response body | Empty on success | ||
| Returns | 201 | Created | |
| 40x | On errors | ||