Versions Compared

Key

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

...

An order is placed at the time of a valid purchase from the end-user.  This is for a product to be made available to the customer in all services. The bookstore calls this on behalf of the customer. If id is specified for an order id, the order is attached to this and can’t be changed. There are some variations in the data you need to send in depending on what type of DRM the book.


Place an order

 

The get inventory service can give data on your entire catalogue or detailed information on one specific tittle. 

...

application/json
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
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)
lastnameOptional*

First name of the person buying the book (Required for all books with SDRM)

excerptOptionalOrder is for excerpt instead of actual book (defaults to false)
Response
headers

 

Content-Type

Location

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

Response
body
ATOM Inventory XML format (see details further down on this page)
Returns200201OKCreated
400Bad Request
401Unauthorized
403Forbidden
406Not Acceptable
500Internal Server Error

 

 

 

Example (curl)

 

Successful creation of an order for a book that does not have social DRM

 

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 '{"orderid":"123456789","resid":"fab4599e-eb2e-445a-a7f9-4af12c052dec","spd":"18900","id":"gaf4599e-fg5e-445a-a7f9-6af14c052dec"}' https://api.dds.boknett.no/order
HTTP/1.1 201 Created
Date: Fri, 07 Aug 2015 13:04:47 GMT
Location: https://api.dds.boknett.no/content/0b1c4e50-bb00-46ea-bc24-27d1b32fb2a3