GET api/books/recommended/{count}

V2 - Retrieves a randomized list of recommended books for the logged in child, depending on which is available.
This list will be randomized.
This method requires an authorized user.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
count

The number of books requested

integer

Default value is 25

Body Parameters

None.

Response Information

Resource Description

IEnumerable collection of YindoBooks

Collection of YindoBook
NameDescriptionTypeAdditional information
bookID

The ID for this book

integer

None.

ean

A 13 digit EAN. This starts with 978- for 'real' books and with 888- for Yindo Custom Books

string

None.

altean

A 13 digit EAN. This starts with 978- for 'real' books and with 888- for Yindo Custom Books

string

None.

title

The title for this book.

string

None.

firstAuthorName

The name for the first author of this book.

string

None.

firstAuthorID

The ID for the first author of this book.

integer

None.

authorName

The list of authors for this book, in a single comma separated string.

string

None.

authorNames

The list of authors for this book.

Collection of YindoSimpleAuthor

None.

credits

The number of credits required to read this book for one month (of this option is available, otherwise the amount is for permanent purchase).

decimal number

None.

description

A description of the book.

string

None.

isBookOnShelf

Boolean value indicating if this book is cuurently on a users bookshelf.
This value does not take temporary of permanent licenses into account.

boolean

None.

offSet

The size of the prework.
This value indicates the difference between the logical pages and physical pages.

integer

None.

numPages

The total number of physical pages in this book.

integer

None.

publisherID

The ID for the publisher.

integer

None.

publisherName

The name of the publisher.

string

None.

serieID

The ID for the series this book is part of, if any.

integer

None.

serieName

The name of the series this book is part of, if any.

string

None.

numBookPrices

The number of available buying options.

integer

None.

languageID

The languageID identifies the language in which the book was written.

  1. NL
  2. EN

integer

None.

isInSubscription

Boolean value indicating if this book is part of one or more subscriptions.

boolean

None.

priceInEuro

The price for this book in eurocents.

string

None.

availablePageRange

A list of pagenumbers that can be read. For preview purposes this list will contain the free pages. When a user has full reading rights to a book (due to a subscription or purchase) the list will contain all pages.

Collection of integer

None.

freePageRange

A list of pagenumbers that can be read. For preview purposes this list will contain the free pages. When a user has full reading rights to a book (due to a subscription or purchase) the list will contain all pages.

Collection of integer

None.

orientation

Page orientarion. Possible values are:

  • portrait
  • landscape
  • square

string

None.

width

Width of the png-page in pixels

integer

None.

height

Height of the png-page in pixels.

integer

None.

isFavorite

Boolean value indicating if this book is a favorite for the currently logged in user.

boolean

None.

lastPageRead

The last page read by the currently logged in user. The value will be -1 if this book hasn't been read yet, of if the book is not on the conventional Yindo bookshelf.

integer

None.

isAvailable

Boolean value indicating i the book is available.

boolean

None.

modifiedOn

The last modification date for this books data.

date

Data type: DateTime

hasToc

Boolean value indicating if this book has a Table of Contents.

boolean

None.

ageIndicator

deprecated The ageIndicator was used by Boekenwolk, nut will be removed in a future release.

string

None.

aviLevels

A list of aviLevels this book is linked to.
If no data is available, this list will be empty.

Collection of AviLevelDetails

None.

ageLevels

A list of ageLevels this book is linked to.
If no data is available, this list will be empty.

Collection of AgeLevelDetails

None.

categories

A list of categories into which this book falls.
If no data is available, this list will be empty.

Collection of CategoryDetails

None.

averageRating

The average of all user ratings for this book.

integer

None.

IPreading

Are we in IP reading mode?

boolean

None.

sessionKey

The key for this user-session

string

None.

sessionIndex

The current session index out of all available sessions

integer

None.

sessionsAvailable

The number of available sessions for this book/IP

integer

None.

sessionQueueIndex

The index into the queue

integer

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "bookID": 1,
    "ean": "sample string 2",
    "altean": "sample string 3",
    "title": "sample string 4",
    "firstAuthorName": "sample string 5",
    "firstAuthorID": 6,
    "authorName": "sample string 7",
    "authorNames": [
      {
        "authorName": "sample string 1",
        "authorID": 2
      },
      {
        "authorName": "sample string 1",
        "authorID": 2
      }
    ],
    "credits": 8.0,
    "description": "sample string 9",
    "isBookOnShelf": true,
    "offSet": 11,
    "numPages": 12,
    "publisherID": 13,
    "publisherName": "sample string 14",
    "serieID": 15,
    "serieName": "sample string 16",
    "numBookPrices": 17,
    "languageID": 18,
    "isInSubscription": true,
    "priceInEuro": "sample string 20",
    "availablePageRange": [
      1,
      2
    ],
    "freePageRange": [
      1,
      2
    ],
    "orientation": "sample string 21",
    "width": 22,
    "height": 23,
    "isFavorite": true,
    "lastPageRead": 25,
    "isAvailable": true,
    "modifiedOn": "2024-11-10T02:31:33.8479223+01:00",
    "hasToc": true,
    "ageIndicator": "sample string 29",
    "aviLevels": [
      {
        "ID": 1,
        "Name": "sample string 2",
        "Description": "sample string 3"
      },
      {
        "ID": 1,
        "Name": "sample string 2",
        "Description": "sample string 3"
      }
    ],
    "ageLevels": [
      {
        "ID": 1,
        "Name": "sample string 2",
        "Description": "sample string 3"
      },
      {
        "ID": 1,
        "Name": "sample string 2",
        "Description": "sample string 3"
      }
    ],
    "categories": [
      {
        "ID": 1,
        "Name": "sample string 2",
        "Description": "sample string 3"
      },
      {
        "ID": 1,
        "Name": "sample string 2",
        "Description": "sample string 3"
      }
    ],
    "averageRating": 30,
    "IPreading": true,
    "sessionKey": "sample string 32",
    "sessionIndex": 33,
    "sessionsAvailable": 34,
    "sessionQueueIndex": 35
  },
  {
    "bookID": 1,
    "ean": "sample string 2",
    "altean": "sample string 3",
    "title": "sample string 4",
    "firstAuthorName": "sample string 5",
    "firstAuthorID": 6,
    "authorName": "sample string 7",
    "authorNames": [
      {
        "authorName": "sample string 1",
        "authorID": 2
      },
      {
        "authorName": "sample string 1",
        "authorID": 2
      }
    ],
    "credits": 8.0,
    "description": "sample string 9",
    "isBookOnShelf": true,
    "offSet": 11,
    "numPages": 12,
    "publisherID": 13,
    "publisherName": "sample string 14",
    "serieID": 15,
    "serieName": "sample string 16",
    "numBookPrices": 17,
    "languageID": 18,
    "isInSubscription": true,
    "priceInEuro": "sample string 20",
    "availablePageRange": [
      1,
      2
    ],
    "freePageRange": [
      1,
      2
    ],
    "orientation": "sample string 21",
    "width": 22,
    "height": 23,
    "isFavorite": true,
    "lastPageRead": 25,
    "isAvailable": true,
    "modifiedOn": "2024-11-10T02:31:33.8479223+01:00",
    "hasToc": true,
    "ageIndicator": "sample string 29",
    "aviLevels": [
      {
        "ID": 1,
        "Name": "sample string 2",
        "Description": "sample string 3"
      },
      {
        "ID": 1,
        "Name": "sample string 2",
        "Description": "sample string 3"
      }
    ],
    "ageLevels": [
      {
        "ID": 1,
        "Name": "sample string 2",
        "Description": "sample string 3"
      },
      {
        "ID": 1,
        "Name": "sample string 2",
        "Description": "sample string 3"
      }
    ],
    "categories": [
      {
        "ID": 1,
        "Name": "sample string 2",
        "Description": "sample string 3"
      },
      {
        "ID": 1,
        "Name": "sample string 2",
        "Description": "sample string 3"
      }
    ],
    "averageRating": 30,
    "IPreading": true,
    "sessionKey": "sample string 32",
    "sessionIndex": 33,
    "sessionsAvailable": 34,
    "sessionQueueIndex": 35
  }
]

text/javascript

Sample:
[{"bookID":1,"ean":"sample string 2","altean":"sample string 3","title":"sample string 4","firstAuthorName":"sample string 5","firstAuthorID":6,"authorName":"sample string 7","authorNames":[{"authorName":"sample string 1","authorID":2},{"authorName":"sample string 1","authorID":2}],"credits":8.0,"description":"sample string 9","isBookOnShelf":true,"offSet":11,"numPages":12,"publisherID":13,"publisherName":"sample string 14","serieID":15,"serieName":"sample string 16","numBookPrices":17,"languageID":18,"isInSubscription":true,"priceInEuro":"sample string 20","availablePageRange":[1,2],"freePageRange":[1,2],"orientation":"sample string 21","width":22,"height":23,"isFavorite":true,"lastPageRead":25,"isAvailable":true,"modifiedOn":"2024-11-10T02:31:33.8479223+01:00","hasToc":true,"ageIndicator":"sample string 29","aviLevels":[{"ID":1,"Name":"sample string 2","Description":"sample string 3"},{"ID":1,"Name":"sample string 2","Description":"sample string 3"}],"ageLevels":[{"ID":1,"Name":"sample string 2","Description":"sample string 3"},{"ID":1,"Name":"sample string 2","Description":"sample string 3"}],"categories":[{"ID":1,"Name":"sample string 2","Description":"sample string 3"},{"ID":1,"Name":"sample string 2","Description":"sample string 3"}],"averageRating":30,"IPreading":true,"sessionKey":"sample string 32","sessionIndex":33,"sessionsAvailable":34,"sessionQueueIndex":35},{"bookID":1,"ean":"sample string 2","altean":"sample string 3","title":"sample string 4","firstAuthorName":"sample string 5","firstAuthorID":6,"authorName":"sample string 7","authorNames":[{"authorName":"sample string 1","authorID":2},{"authorName":"sample string 1","authorID":2}],"credits":8.0,"description":"sample string 9","isBookOnShelf":true,"offSet":11,"numPages":12,"publisherID":13,"publisherName":"sample string 14","serieID":15,"serieName":"sample string 16","numBookPrices":17,"languageID":18,"isInSubscription":true,"priceInEuro":"sample string 20","availablePageRange":[1,2],"freePageRange":[1,2],"orientation":"sample string 21","width":22,"height":23,"isFavorite":true,"lastPageRead":25,"isAvailable":true,"modifiedOn":"2024-11-10T02:31:33.8479223+01:00","hasToc":true,"ageIndicator":"sample string 29","aviLevels":[{"ID":1,"Name":"sample string 2","Description":"sample string 3"},{"ID":1,"Name":"sample string 2","Description":"sample string 3"}],"ageLevels":[{"ID":1,"Name":"sample string 2","Description":"sample string 3"},{"ID":1,"Name":"sample string 2","Description":"sample string 3"}],"categories":[{"ID":1,"Name":"sample string 2","Description":"sample string 3"},{"ID":1,"Name":"sample string 2","Description":"sample string 3"}],"averageRating":30,"IPreading":true,"sessionKey":"sample string 32","sessionIndex":33,"sessionsAvailable":34,"sessionQueueIndex":35}]

application/xml, text/xml

Sample:
<ArrayOfYindoBook xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Yindo">
  <YindoBook>
    <IPreading>true</IPreading>
    <ageIndicator>sample string 29</ageIndicator>
    <ageLevels xmlns:d3p1="http://schemas.datacontract.org/2004/07/Yindo.DAL.Types">
      <d3p1:AgeLevelDetails>
        <d3p1:Description>sample string 3</d3p1:Description>
        <d3p1:ID>1</d3p1:ID>
        <d3p1:Name>sample string 2</d3p1:Name>
      </d3p1:AgeLevelDetails>
      <d3p1:AgeLevelDetails>
        <d3p1:Description>sample string 3</d3p1:Description>
        <d3p1:ID>1</d3p1:ID>
        <d3p1:Name>sample string 2</d3p1:Name>
      </d3p1:AgeLevelDetails>
    </ageLevels>
    <altean>sample string 3</altean>
    <authorName>sample string 7</authorName>
    <authorNames>
      <YindoSimpleAuthor>
        <authorID>2</authorID>
        <authorName>sample string 1</authorName>
      </YindoSimpleAuthor>
      <YindoSimpleAuthor>
        <authorID>2</authorID>
        <authorName>sample string 1</authorName>
      </YindoSimpleAuthor>
    </authorNames>
    <availablePageRange xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:int>1</d3p1:int>
      <d3p1:int>2</d3p1:int>
    </availablePageRange>
    <averageRating>30</averageRating>
    <aviLevels xmlns:d3p1="http://schemas.datacontract.org/2004/07/Yindo.DAL.Types">
      <d3p1:AviLevelDetails>
        <d3p1:Description>sample string 3</d3p1:Description>
        <d3p1:ID>1</d3p1:ID>
        <d3p1:Name>sample string 2</d3p1:Name>
      </d3p1:AviLevelDetails>
      <d3p1:AviLevelDetails>
        <d3p1:Description>sample string 3</d3p1:Description>
        <d3p1:ID>1</d3p1:ID>
        <d3p1:Name>sample string 2</d3p1:Name>
      </d3p1:AviLevelDetails>
    </aviLevels>
    <bookID>1</bookID>
    <categories xmlns:d3p1="http://schemas.datacontract.org/2004/07/Yindo.DAL.Types">
      <d3p1:CategoryDetails>
        <d3p1:Description>sample string 3</d3p1:Description>
        <d3p1:ID>1</d3p1:ID>
        <d3p1:Name>sample string 2</d3p1:Name>
      </d3p1:CategoryDetails>
      <d3p1:CategoryDetails>
        <d3p1:Description>sample string 3</d3p1:Description>
        <d3p1:ID>1</d3p1:ID>
        <d3p1:Name>sample string 2</d3p1:Name>
      </d3p1:CategoryDetails>
    </categories>
    <credits>8</credits>
    <description>sample string 9</description>
    <ean>sample string 2</ean>
    <firstAuthorID>6</firstAuthorID>
    <firstAuthorName>sample string 5</firstAuthorName>
    <freePageRange xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:int>1</d3p1:int>
      <d3p1:int>2</d3p1:int>
    </freePageRange>
    <hasToc>true</hasToc>
    <height>23</height>
    <isAvailable>true</isAvailable>
    <isBookOnShelf>true</isBookOnShelf>
    <isFavorite>true</isFavorite>
    <isInSubscription>true</isInSubscription>
    <languageID>18</languageID>
    <lastPageRead>25</lastPageRead>
    <modifiedOn>2024-11-10T02:31:33.8479223+01:00</modifiedOn>
    <numBookPrices>17</numBookPrices>
    <numPages>12</numPages>
    <offSet>11</offSet>
    <orientation>sample string 21</orientation>
    <priceInEuro>sample string 20</priceInEuro>
    <publisherID>13</publisherID>
    <publisherName>sample string 14</publisherName>
    <serieID>15</serieID>
    <serieName>sample string 16</serieName>
    <sessionIndex>33</sessionIndex>
    <sessionKey>sample string 32</sessionKey>
    <sessionQueueIndex>35</sessionQueueIndex>
    <sessionsAvailable>34</sessionsAvailable>
    <title>sample string 4</title>
    <width>22</width>
  </YindoBook>
  <YindoBook>
    <IPreading>true</IPreading>
    <ageIndicator>sample string 29</ageIndicator>
    <ageLevels xmlns:d3p1="http://schemas.datacontract.org/2004/07/Yindo.DAL.Types">
      <d3p1:AgeLevelDetails>
        <d3p1:Description>sample string 3</d3p1:Description>
        <d3p1:ID>1</d3p1:ID>
        <d3p1:Name>sample string 2</d3p1:Name>
      </d3p1:AgeLevelDetails>
      <d3p1:AgeLevelDetails>
        <d3p1:Description>sample string 3</d3p1:Description>
        <d3p1:ID>1</d3p1:ID>
        <d3p1:Name>sample string 2</d3p1:Name>
      </d3p1:AgeLevelDetails>
    </ageLevels>
    <altean>sample string 3</altean>
    <authorName>sample string 7</authorName>
    <authorNames>
      <YindoSimpleAuthor>
        <authorID>2</authorID>
        <authorName>sample string 1</authorName>
      </YindoSimpleAuthor>
      <YindoSimpleAuthor>
        <authorID>2</authorID>
        <authorName>sample string 1</authorName>
      </YindoSimpleAuthor>
    </authorNames>
    <availablePageRange xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:int>1</d3p1:int>
      <d3p1:int>2</d3p1:int>
    </availablePageRange>
    <averageRating>30</averageRating>
    <aviLevels xmlns:d3p1="http://schemas.datacontract.org/2004/07/Yindo.DAL.Types">
      <d3p1:AviLevelDetails>
        <d3p1:Description>sample string 3</d3p1:Description>
        <d3p1:ID>1</d3p1:ID>
        <d3p1:Name>sample string 2</d3p1:Name>
      </d3p1:AviLevelDetails>
      <d3p1:AviLevelDetails>
        <d3p1:Description>sample string 3</d3p1:Description>
        <d3p1:ID>1</d3p1:ID>
        <d3p1:Name>sample string 2</d3p1:Name>
      </d3p1:AviLevelDetails>
    </aviLevels>
    <bookID>1</bookID>
    <categories xmlns:d3p1="http://schemas.datacontract.org/2004/07/Yindo.DAL.Types">
      <d3p1:CategoryDetails>
        <d3p1:Description>sample string 3</d3p1:Description>
        <d3p1:ID>1</d3p1:ID>
        <d3p1:Name>sample string 2</d3p1:Name>
      </d3p1:CategoryDetails>
      <d3p1:CategoryDetails>
        <d3p1:Description>sample string 3</d3p1:Description>
        <d3p1:ID>1</d3p1:ID>
        <d3p1:Name>sample string 2</d3p1:Name>
      </d3p1:CategoryDetails>
    </categories>
    <credits>8</credits>
    <description>sample string 9</description>
    <ean>sample string 2</ean>
    <firstAuthorID>6</firstAuthorID>
    <firstAuthorName>sample string 5</firstAuthorName>
    <freePageRange xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:int>1</d3p1:int>
      <d3p1:int>2</d3p1:int>
    </freePageRange>
    <hasToc>true</hasToc>
    <height>23</height>
    <isAvailable>true</isAvailable>
    <isBookOnShelf>true</isBookOnShelf>
    <isFavorite>true</isFavorite>
    <isInSubscription>true</isInSubscription>
    <languageID>18</languageID>
    <lastPageRead>25</lastPageRead>
    <modifiedOn>2024-11-10T02:31:33.8479223+01:00</modifiedOn>
    <numBookPrices>17</numBookPrices>
    <numPages>12</numPages>
    <offSet>11</offSet>
    <orientation>sample string 21</orientation>
    <priceInEuro>sample string 20</priceInEuro>
    <publisherID>13</publisherID>
    <publisherName>sample string 14</publisherName>
    <serieID>15</serieID>
    <serieName>sample string 16</serieName>
    <sessionIndex>33</sessionIndex>
    <sessionKey>sample string 32</sessionKey>
    <sessionQueueIndex>35</sessionQueueIndex>
    <sessionsAvailable>34</sessionsAvailable>
    <title>sample string 4</title>
    <width>22</width>
  </YindoBook>
</ArrayOfYindoBook>