boekenliefde.nl API > user_tips_editions_get
status: Active
Geeft een overzicht van persoonlijke boekentips voor een gebruiker die de apipartner heeft gemachtigd. De resultaten kunnen leeg zijn, met name als nog geen of weinig waarderingen van boeken door de gebruiker bekend zijn. Dat is geen fout.
Inputparameters
key (vereist, text)
api key
user_id (optioneel, integer/text)
boekenliefde.nl gebruikersnummer van de aanvrager die de apipartner heeft gemachtigd
offset (optioneel, integer/text)
Geef de edities vanaf positie, standaard 0. Met behulp van de invoerparameter offset kunnen alle resultaten worden opgehaald.
waitmaxseconds (optioneel, integer/text)
Deze functie kan in de praktijk soms lang duren (tientallen seconden). Met deze optie kan worden ingesteld, dat de api uiterlijk een reactie geeft na een aantal seconden (minimum 3). De parameter readyloading geeft dan aan of het laden klaar is. Het laden gaat op de achtergrond verder; na herhaalde aanroepen zal de readyloading waar zijn. Standaard 9999.
max (optioneel, integer/text)
Maximum aantal resultaten. Default is op dit moment 50. Maximum is momenteel 250. Met behulp van de parameter offset kunt u alle resultaten opvragen.
outputformat (optioneel, text)
Output is standaard in json-formaat. Parameterwaarde 'xml' geeft als output een zo goed mogelijk xml-equivalent met 'response' als document-tag.
Output (jsonobject)
resultcode (text)
code voor resultaat. SUCCESS ERROR_USERUNKNOWN ERROR_NOTAUTHORIZED
numberoftips (integer)
Aantal boekentips
readyloading (boolean)
Als het laden van recommendations te lang duurt, geeft de api readyloading false terug. De call kan dan opnieuw aangeroepen worden.
offset (integer)
Gebruikte waarde voor invoerparameter offset
max (integer)
Gebruikte waarde voor invoerparameter max
editions (jsonarray of jsonobjects)
Edities
edition_id (integer)
boekenliefde.nl editienummer
author (text)
Auteur of samensteller volgens boekenliefde.nl. Eventueel meerdere in leesbaar tekstfragment.
title (text)
Titel volgens boekenliefde.nl
image (text)
URL van plaatje bij boekenliefde.nl
link (text)
URL van uitgave bij boekenliefde.nl
isbn (text)
ISBN-13 indien beschikbaar; anders ontbrekend
rating (integer)
rating van eigenaar boekenplank, 0 indien geen rating gegeven. Bij een tip hoort de rating 0 te zijn.
boekenliefde.nl api
Behalve de vermelde resultcodes zijn er algemene foutmeldingen: ERROR_NOTSECURE ERROR_NOKEY ERROR_INVALIDKEY ERROR_KEYLIMITEXCEEDED ERROR_UNKNOWNFUNCTION ERROR_SERVER
Heeft u vragen, lijkt het niet goed te werken, of heeft u behoefte aan meer mogelijkheden, laat het weten.

Login






