Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

From autumn 2016 Bokbasen have been 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 


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. For details on how to user next and after parameters see: Export Service#Parameters

You are welcome to migrate to this endpoint even if you do not plan to import international e-books. The performance of this endpoint is dramatically improved compared to v1 and you will be able to load this data much faster. However, note that you will see a much larger number of books with access=false if you do not have a contract to sell international titles. Still, with the significant improvement in load time this is a more efficient way of loading Inventory data for Norwegian titles as well.


URL

https://api.dds.boknett.no/v2/inventory/

 https://api.dds.boknett.no/v2/inventory/{isbn}

MethodGET
Request
headers

Authorization

Required

The token acquired from the Authentication Service (legacy).

Formated "Boknett TGT-...."

DateRequiredThe timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT
Query
parameters
afterRequired if next not given
nextRequired if after not given
pagesizeoptional(defaults to 10000)
Response
headers


Content-Type

application/atom+xml;charset=UTF-8


Nextnext token for next page

Linklink to next page
Response
body
ATOM Inventory XML format (same format as before, however only latest version of each book is returned and some fields are removed)
Returns200OK
40xOn error


ATOM Inventory XML format for v2

For v2 some fields are removed, contact us if we have removed fields that are important for your process. 

Example XML:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:inv="http://bokbasen.no/module/inventory/1.0">
  <title>Inventory Items</title>
  <link rel="self" type="application/atom+xml" href="http://api.dds.boknett.no/inventory/" title="Inventory feed" />
  <updated>2015-08-07T11:19:45Z</updated>
  <entry>
    <id>urn:uuid:99496f82-84c5-4de7-9899-31603e26a355</id>
    <updated>2015-08-06T11:52:09Z</updated>
    <inv:isbn>9788242160966</inv:isbn>
    <inv:publisher>900224</inv:publisher>
    <inv:format>MP3</inv:format>
    <inv:drm>SDRM</inv:drm>
    <inv:version>1</inv:version>
    <inv:deleted />
    <inv:published>true</inv:published>
    <inv:access>false</inv:access>
    <inv:excerpt>false</inv:excerpt>
  </entry>
</feed>



Place an order

International books requires additional fields for order where country code and zip code for the buyer is required. The country code will be validated against the metadata to ensure that the book is being sold in a market where you are allowed to sell it.


URLhttps://api.dds.boknett.no/order
MethodPOST
Request
headers

Authorization

Required

The token acquired from the Authentication Service.

Formated "Boknett TGT-...."

DateRequiredThe timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT
AcceptRequiredapplication/json (We recommend all new implementations to use this header, XML support will be phased out in the future)
Content-typeRequiredapplication/json
JSON attributesorderidRequiredYour store order ID. Used as transaction ID in DDS. Must be unique for a purchase.
residRequiredThe product ID in DDS. Unique name for e-/audio books found in the inventory service.
spdRequiredPrice in Norwegian "øre"  (sold for) including VAT. Example NOK 189 = 18900
idOptionalDDS-ID for end-consumer

firstname

Optional*First name of the person buying the book (Required for all books with SDRM, minimum length 2)
lastnameOptional*

First name of the person buying the book (Required for all books with SDRM, minimum length 2)

excerptOptionalOrder is for excerpt instead of actual book (defaults to false)
countryRequired for international booksISO 3166-1 code for country the buyer lives in (must correspond with SalesRights from the metadata feed, DDS will reject transaction if an order is placed for a customer living in a country where SalesRights are not present)
zipRequired for international booksZip code where the customer lives (if not available, default to company zip code)
Response
headers


Location

https://api.dds.boknett.no/content/{fulfilmentId}

Response
body
Empty on success
Returns201Created
40xOn errors
  • No labels