Inventory Items

{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"14391971-a6ad-4fcc-b18c-41dd68005d4f"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"16813d07-2324-426f-81c8-e7e278b46e31"}},{"type":"paragraph","content":[{"text":"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 ","type":"text"},{"text":"Metadata Export Service","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/api/pages/48955432"}}]},{"text":" The response is delivered in XML as an ATOM feed. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Get inventory (v2)","type":"text"}]},{"type":"paragraph","content":[{"text":"The new interface for inventory is updated 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 ","type":"text"},{"text":"Export Service","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/api/pages/48955432"}}]},{"text":". For details on how to user next and after parameters see: ","type":"text"},{"text":"Export Service#Parameters","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/api/pages/48955432#ExportService-Parameters"}}]}]},{"type":"paragraph","content":[{"text":" 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.","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note that if you do lookup on ","type":"text"},{"text":"isbn","type":"text","marks":[{"type":"strong"}]},{"text":", all versions of the book will be returned, not just the latest one.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"New Authentication & URLs introduced Q2 2024","type":"text"}]}]},{"type":"table","attrs":{"layout":"wide","width":960.0,"localId":"283caf55-0c75-40d2-ae18-e9bd4284015d"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"URL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":3,"rowspan":1,"colwidth":[130.0,226.0,485.0]},"content":[{"type":"paragraph","content":[{"text":"https://api.bokbasen.io/dds/inventory/v2","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"https://api.bokbasen.io/dds/inventory/v2/{isbn}","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph"},{"type":"nestedExpand","attrs":{"title":"Legacy"},"content":[{"type":"paragraph","content":[{"text":"https://api.dds.boknett.no/v2/inventory/","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"https://api.dds.boknett.no/v2/inventory/{isbn}","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The token acquired from the ","type":"text"},{"text":"Authentication Service","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/api/pages/48955430"}}]},{"text":". Example: ","type":"text"},{"text":"Authorization: Boknett TGT-....","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Header: ","type":"text"},{"text":"Date","type":"text","marks":[{"type":"code"}]},{"text":" is required. The timestamp the request was made. Must comply with ","type":"text"},{"text":"RFC 1123","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.ietf.org/rfc/rfc1123.txt"}}]},{"text":" date formats. Example: ","type":"text"},{"text":"Tue, 10 Jun 2014 16:23:42 GMT","type":"text","marks":[{"type":"code"}]}]}]},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":3,"rowspan":1,"colwidth":[130.0,226.0,485.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text"},{"type":"hardBreak"},{"text":"headers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"Authorization","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[485.0]},"content":[{"type":"paragraph","content":[{"text":"The token acquired from the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://bokbasen.jira.com/wiki/spaces/api/pages/2994962433"}},{"text":" .","type":"text"}]},{"type":"paragraph","content":[{"text":"Audience: ","type":"text"},{"text":"https://api.bokbasen.io/dds/","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Example: ","type":"text"},{"text":"Authorization: Bearer ....","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":3,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"Query","type":"text"},{"type":"hardBreak"},{"text":"parameters","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"after","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Required if next not given","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[485.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"next","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Required if after not given","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[485.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"pagesize","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[485.0]},"content":[{"type":"paragraph","content":[{"text":"(default and max value is 10000)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"Response","type":"text"},{"type":"hardBreak"},{"text":"headers","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"Content-Type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[226.0,485.0]},"content":[{"type":"paragraph","content":[{"text":"application/atom+xml;charset=UTF-8","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"Next","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[226.0,485.0]},"content":[{"type":"paragraph","content":[{"text":"next token for next page","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"Link","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[226.0,485.0]},"content":[{"type":"paragraph","content":[{"text":"link to next page","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"Response","type":"text"},{"type":"hardBreak"},{"text":"body","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":3,"rowspan":1,"colwidth":[130.0,226.0,485.0]},"content":[{"type":"paragraph","content":[{"text":"ATOM Inventory XML format (same format as before, however only latest version of each book is returned and some fields are removed)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":2,"colwidth":[119.0]},"content":[{"type":"paragraph","content":[{"text":"Returns","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"200","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[226.0,485.0]},"content":[{"type":"paragraph","content":[{"text":"OK","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[130.0]},"content":[{"type":"paragraph","content":[{"text":"40x","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[226.0,485.0]},"content":[{"type":"paragraph","content":[{"text":"On error","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Curl example","type":"text"}]},{"type":"paragraph","content":[{"text":"Initial load using ","type":"text"},{"text":"after","type":"text","marks":[{"type":"code"}]},{"text":" (timestamp) - if you are not using your persisted ","type":"text"},{"text":"next","type":"text","marks":[{"type":"code"}]},{"text":" from last call/session","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -i \\\n -H \"Authorization: Bearer \" \\\n \"https://api.bokbasen.io/dds/inventory/v2?after=20140501120000\"\n\nHTTP/1.1 200 OK\nDate: Fri, 07 Aug 2015 11:19:45 GMT\nContent-Type: application/atom+xml;charset=UTF-8\n\n(ATOM Inventory XML)","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Curl example ","type":"text"},{"type":"status","attrs":{"color":"yellow","style":"bold","text":"legacy example","localId":"f53b2ebf-46f5-4f56-b1c7-6c638b718cc5"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Initial load using ","type":"text"},{"text":"after","type":"text","marks":[{"type":"code"}]},{"text":" (timestamp) - if you are not using your persisted ","type":"text"},{"text":"next","type":"text","marks":[{"type":"code"}]},{"text":" from last call/session","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -i \\\n -H \"Authorization: Boknett TGT-19933-EcDNpJfVcJNrpcMeGvGKcfUHvV1W2MR50zb066X6vTZVTypXBQ-login.boknett.no\" \\\n -H \"Date: Fri, 07 Aug 2015 11:18:39 GMT\" \\\n \"https://api.dds.boknett.no/v2/inventory/?after=20140501120000\"\n\nHTTP/1.1 200 OK\nDate: Fri, 07 Aug 2015 11:19:45 GMT\nContent-Type: application/atom+xml;charset=UTF-8\n\n(ATOM Inventory XML)","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ATOM Inventory XML format for v2","type":"text"}]},{"type":"paragraph","content":[{"text":"For v2 some fields are removed, contact us if we have removed fields that are important for your process. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example XML: ","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n Inventory Items\n \n 2015-08-07T11:19:45Z\n \n urn:uuid:99496f82-84c5-4de7-9899-31603e26a355\n 2015-08-06T11:52:09Z\n 9788242160966\n 900224\n MP3\n SDRM\n 1\n \n true\n false\n false\n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Inventory XML element documentation","type":"text"},{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"2cf15801-0b05-4ec9-82d1-1ad9b424acb9"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"Element ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"Explanation","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"title","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"Title of book","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"author","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"name","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"Name of author ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"The id of the digital resource representing the book. (Referred to as uuid or reId) Note that this ID can change at any time if the publisher of the book publishes a new version of the digital file. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"updated","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"Last time resource was updated","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"inv:isbn","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"ISBN of book ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"inv:publisher","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"Id of publisher ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"inv:format","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"Format of the file (always MP3 for audio books even if they are distributed in different formats)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"inv:drm","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"What kind of DRM protection the book have, possible values are: SDRM, TDRM, NODRM, or UNKNOWN","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"inv:version","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"Version number for the digital resource. Starts with 1 and increments if new version of the digital book is published.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"inv:firstpublished","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"Date book was first published","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"inv:deleted","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"Date book was deleted (empty value if not deleted)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"inv:published","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"If the books in published, you cannot initiate downloads on a book that is not published.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"inv:access","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"Role based, do you as an integrator have access to this book? Must be true in order for you to sell the title.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"inv:excerpt","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[577.0]},"content":[{"type":"paragraph","content":[{"text":"If excerpts are available through DDS. (Will always be false for audio books as these are distributed through the metadata API.)","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Get inventory (v1) ","type":"text"},{"type":"status","attrs":{"color":"yellow","style":"bold","text":"Deprecated","localId":"f966e846-5b4c-45d3-83cd-5e7addd597c5"}},{"text":" ","type":"text"},{"type":"hardBreak"}]},{"type":"expand","attrs":{"title":"Details"},"marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"paragraph","content":[{"text":"The get inventory service can give data on your entire catalogue or detailed information on one specific title.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"This service is deprecated for inventory v2.","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"paragraph"},{"type":"table","attrs":{"layout":"full-width","localId":"83777459-e3cb-4ade-b4bb-26d7a162acfc"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"URL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":3,"rowspan":1,"colwidth":[138.0,118.0,607.0]},"content":[{"type":"paragraph","content":[{"text":"https://api.dds.boknett.no/inventory/","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":3,"rowspan":1,"colwidth":[138.0,118.0,607.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":2,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text"},{"type":"hardBreak"},{"text":"headers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Authorization","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[607.0]},"content":[{"type":"paragraph","content":[{"text":"The token acquired from the ","type":"text"},{"text":"Authentication Service","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Formated \"Boknett TGT-....\"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[607.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp the request was made. Must comply with ","type":"text"},{"text":"RFC 1123","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.ietf.org/rfc/rfc1123.txt"}}]},{"text":" date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":5,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"Query","type":"text"},{"type":"hardBreak"},{"text":"parameters","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"id","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[607.0]},"content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"isbn","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[607.0]},"content":[{"type":"paragraph","content":[{"text":"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)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"fromDate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[607.0]},"content":[{"type":"paragraph","content":[{"text":"From date for the response dataset","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"toDate ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[607.0]},"content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"state","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"Optional*","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[607.0]},"content":[{"type":"paragraph","content":[{"text":"Status that can be used for filtering.","type":"text"}]},{"type":"paragraph","content":[{"text":"*If fromDate or toDate is given, this is mandatory","type":"text"}]},{"type":"paragraph","content":[{"text":"Possible values:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PUBLISHED","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"UNPUBLISHED","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CREATED","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MODIFIED","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DELETED","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FIRST_PUBLISHED","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ACCESS","type":"text","marks":[{"type":"strong"}]}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"Response","type":"text"},{"type":"hardBreak"},{"text":"headers","type":"text"}]},{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"Content-Type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[118.0,607.0]},"content":[{"type":"paragraph","content":[{"text":"application/atom+xml;charset=UTF-8","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"Response","type":"text"},{"type":"hardBreak"},{"text":"body","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":3,"rowspan":1,"colwidth":[138.0,118.0,607.0]},"content":[{"type":"paragraph","content":[{"text":"ATOM Inventory XML format (see details further down on this page)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":2,"colwidth":[118.0]},"content":[{"type":"paragraph","content":[{"text":"Returns","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"200","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[118.0,607.0]},"content":[{"type":"paragraph","content":[{"text":"OK","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[138.0]},"content":[{"type":"paragraph","content":[{"text":"40x","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[118.0,607.0]},"content":[{"type":"paragraph","content":[{"text":"On error","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Details on state and fromDate / toDate parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"These parameters works together differently based on which data type the field in state has. For all fields that are dates (UNPUBLISHED, CREATED, MODIFIED, FIRST_PUBLISHED, DELETED) the fromDate / toDate parameters are used in combination with the state field. So state=MODIFIED&fromDate=08082015&toDate=10082015 will only returned books that are modified in this time period. If not state is given in combination with the date fields MODIFIED will be used as default.","type":"text"}]},{"type":"paragraph","content":[{"text":"For boolean fields (PUBLISHED, ACCESS) the dateFields have no impact and state=ACCESS will just return all books you have access to.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Example (curl)","type":"text"}]},{"type":"paragraph","content":[{"text":"Download inventory for your user.","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -i -H \"Authorization: Boknett TGT-19933-EcDNpJfVcJNrpcMeGvGKcfUHvV1W2MR50zb066X6vTZVTypXBQ-login.boknett.no\" -H \"Date: Fri, 07 Aug 2015 11:18:39 GMT\" \"https://api.dds.boknett.no/inventory/\"\n\nHTTP/1.1 200 OK\nDate: Fri, 07 Aug 2015 11:19:45 GMT\nContent-Type: application/atom+xml;charset=UTF-8\n\n(ATOM Inventory XML)","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"ATOM Inventory XML format","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Example XML:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n Inventory Items\n \n 2015-08-07T11:19:45Z\n \n Tur i skogen\n \n Kari Nordmann\n \n urn:uuid:99496f82-84c5-4de7-9899-31603e26a355\n 2015-08-06T11:52:09Z\n 9788242160966\n 900224\n MP3\n SDRM\n 1\n 2015-08-06T11:52:09Z\n \n true\n false\n false\n \n \n Lengre turer i skogen\n \n Ola Nordmann\n \n urn:uuid:8d9f423c-6caf-4f9c-aee4-8d8bb34656b2\n 2015-08-06T11:24:42Z\n 9788242161024\n 900224\n MP3\n SDRM\n 5\n \n \n false\n false\n false\n \n","type":"text"}]},{"type":"paragraph"}]},{"type":"paragraph"}],"version":1}