Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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
URL

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

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

 

MethodGET
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
Query
parameters
afterOptionalUUID (also called resId) of the ebook that you want information about, use this parameter only if you want detailed information about one single title.nextOptionalRequired if next not given 
nextRequired if after not given 
pagesizeoptional(default and max values to be determined)
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)
Returns200OK
40xOn error

 

Place an order

International books requires additional fields for order

 

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 int booksISO 3166-1 code for country the purchase is made in
zipRequired for int books 
Response
headers

 

Location

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

Response
body
Empty on success
Returns201Created
40xOn errors