Page Comparison

This web service retrieves information about all e-/audio books available in DDS based on your users access rights and permissions. It is essential that you as a retailer check your inventory regularly (minimum every 24 hours) and update your store based on the information found in the inventory. The inventory only provides DDS specific data on each book and must be used in combination with the data from the Metadata Export Service The response is delivered in XML as an ATOM feed.

Get inventory

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

...

URL

https://api.dds.boknett.no/inventory/?id={id}

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

id

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.

isbn

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)

fromDate

Optional

From date for the response dataset

toDate

Optional

The type of notification, which can be updated (new and updated elements) and deleted. Empty or missing parameter will result in both updated and deleted elements.

state

Optional*

Status that can be used for filtering.

*If fromDate or toDate is given, this is mandatory

Possible values:

PUBLISHED

UNPUBLISHED

CREATED

MODIFIED

DELETED

FIRST_PUBLISHED

ACCESS

Response
headers

Link

See Pagination

Content-Type

application/atom+xml;charset=UTF-8

Response
body

ATOM Inventory XML format (see details further down on this page)

Returns

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

406

Not Acceptable

500

Internal Server Error

...

Download inventory for your user.

Code Block

$curlcurl -i -H "Authorization: Boknett TGT-1990419933-0cqlweU6YbxayRp0CHuhU1pcaKy3X4oevypdEfirkKf5m4bPd4EcDNpJfVcJNrpcMeGvGKcfUHvV1W2MR50zb066X6vTZVTypXBQ-login.boknett.no" -H "Date: Fri, 707 Aug 2015 1011:5318:4439 GMT" '"https://api.dds.boknett.no/inventory/'


 "

HTTP/1.1 200 OK
Date: Fri, 07 Aug 2015 11:19:45 GMT
Content-Type: application/atom+xml;charset=UTF-8

(ATOM Inventory XML)

ATOM Inventory XML format

...

Code Block

language	xml

<?xml version="1.0" encoding="utfUTF-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="httpshttp://api.dds.boknett.no/dds-service-store/inventory/" title="Inventory Feedfeed" />
  <updated>2003<updated>2015-1208-13T1807T11:3019:02Z<45Z</updated>
  <!-- sort by updated -->
  <entry><entry>
    <title />
    <author>
      <name />
    <title>meta.title<</title>author>
    <id>urn:uuid:099d995499496f82-c77e84c5-4d084de7-992e9899-bf9f098739c1<31603e26a355</id>
    <updated>b.updated: 2011-09-15T09:03:11Z</updated>
    <created>2009-06-12T10:00:00Z</created>
    <authors>
      <author>
  <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:firstpublished>2015-08-06T11:52:09Z</inv:firstpublished>
    <inv:deleted />
    <inv:published>true</inv:published>
    <inv:access>false</inv:access>
    <inv:excerpt>false</inv:excerpt>
  </entry>
  <entry>
    <title <name>metea.author</name>
 />
    <author>
      <name />
    </author>
    <id>urn:uuid:8d9f423c-6caf-4f9c-aee4-8d8bb34656b2</id>
    </authors><updated>2015-08-06T11:24:42Z</updated>
    <inv:isbn>21913344556<isbn>9788242161024</inv:isbn>
    <inv:publisher>-100<publisher>900224</inv:publisher>
    <inv:format>EPUB<format>MP3</inv:format>
    <inv:drm>NON_DRM<drm>SDRM</inv:drm>
    <inv:version>2<version>5</inv:version>
    <inv:firstpublished>2009-06-28T16:23:00Z</inv:firstpublished>firstpublished />
    <inv:deleted /> Optional date field
    <inv:published>true|false<published>false</inv:published>
    <inv:access>trueaccess>false</false</inv:access>
    <inv:excerpt>true/false<excerpt>false</inv:excerpt>
  </entry>
</feed>

...

Versions Compared

Old Version 1

New Version 2

Key

Get inventory

ATOM Inventory XML format