Integratie Whitelabel product reviews op eigen site

[view this text in English]

Om de productreviews van Kieskeurig.nl door te kunnen plaatsen op jouw website, heb je toegang tot de rest-API van Kieskeurig.nl nodig. Deze toegang wordt geregeld door een token, welke door Kieskeurig.nl wordt verstrekt. Indien je ook de Whitelabel Review iframe gebruikt, kun je hiervoor hetzelfde token gebruiken.

REST-call

Voor het doorplaatsen van productreviews op jouw website, gebruik je onderstaande REST-call. Deze REST-call geeft een XML met alle reviews van een specifiek product en het totale beoordelingscijfer.

http://rest-ext.kieskeurig.nl/[token]/product.html?_a=reviews&product_id=[id]&ratings=[true/false]

Parameters

In de REST-call vind je twee parameters die nog ingevuld moeten worden, alvorens de REST-call van Kieskeurig.nl te kunnen gebruiken:

parameter	waardes	vereist
product_id	product uid/EAN-code**	ja
token	key	ja
ratings	true of false	ja

Verklaring parameters

[token] unieke toegangscode om toegang te krijgen tot de REST-call.
[product_id] het id/uid van het product zoals gebruikt in de kieskeurig.nl product-urls. Of de EAN-code van het product.**
[ratings] true geeft alle deelcijfers van de review, false enkel het totaal-cijfer.

**Product_id of EAN-code

Het is zeer aan te bevelen de aanroep van de restcall op EAN-code te doen. Product-id’s willen nog wel eens vervallen indien een product wordt aangepast, EAN-codes blijven altijd het juiste product teruggeven.

Een product in de kieskeurig database kan meerdere EAN-codes hebben, al deze EAN-codes zijn geschikt om het product te selecteren.

Wat neem je over uit de REST-call

De REST-call geeft een XML, waarvan de volgende velden minimaal getoond moeten worden om de reviews van Kieskeurig.nl op de juiste manier op jouw website te kunnen plaatsen:
<title>
<text> (volledig)
<name>
<date>
<cijfer>
<section>“review_link”

Voorbeeld XML

<resultset version="7.4.0.0" reqver_maj="2" reqver_min="9" build_date="2017-03-01 12:14">
<product_id>3334080</product_id>
<reviewspage>https://www.kieskeurig.nl/smartphone/samsung/galaxyj5(2016)/reviews/3334080/</reviewspage>
<body>
<metakeywords>Samsung Galaxy J5 (2016),..., mobieltjes ,..., GalaxyJ5(2016), SMJ510FZKNPHN</metakeywords>
<behaviorkind>hardware</behaviorkind>
<product>Samsung Galaxy J5 (2016)</product>
<pcode ati_id="14054" subtype="normal">gsm</pcode>
<merk>Samsung</merk>
<type>Galaxy J5 (2016)</type>
<ean>8806088416328</ean>
<lifecycle>normal</lifecycle>
<hits>17</hits>
<page>1</page>
<metadata>
<count/>
<count_consumer/>
<count_expert/>
</metadata>
<section name="review" id="5980698" review_link_id="5980698" review_link="https://www.kieskeurig.nl/smartphone/samsung/galaxyj5(2016)/reviews/3334080/tweakradje/5980698" approved="Y" recommend="N">
<text>Kom van een Samsung Core (2013) uit toen dezelfde prijsklasse. Uiteraard net als deze ook gelijk geroot. Vreemd dat qualcomm de snapdragon 410 cpu op minimaal 800 Mhz fixed, terwijl dat naar 200 Mhz kan. Ook core uitschakeling is niet geactiveerd. </text>
<text_raw>Kom van een Samsung Core (2013) uit toen dezelfde prijsklasse. Uiteraard net als deze ook gelijk geroot. Vreemd dat qualcomm de snapdragon 410 cpu op minimaal 800 Mhz fixed, terwijl dat naar 200 Mhz kan. Ook core uitschakeling is niet geactiveerd.</text_raw>
<date dt="2017-01-11T08:35:05">11-01-2017</date>
<name>tweakradje</name>
<title>Standaard goed toestel</title>
<link_url/>
<form>review</form>
<cijfer>8</cijfer>
<inbezit>paar weken</inbezit>
<pros>
<pro>beeldscherm</pro>
<pro>snel genoeg</pro>
<pro>gps perfect!</pro>
<pro>verwisselbare, grote accu</pro>
<pro>voelt stevig</pro>
</pros>
<cons>
<con>geen notificatie led, backlight toetsen</con>
<con>geen kompas, lichtsensor</con>
<con>Stock Camera matig, gebruik OpenCamera</con>
<con>Qualcomm cpu regeling slecht</con>
<con>matige achter speaker</con>
</cons>
</section>

Verklaring(relevante) XML-nodes

node verklaring
<product_id> het Id/Uid van het product.
<reviewspage> link naar de reviewoverzichtpagina van het product.
<product> korte productbeschrijving van het product.
<pcode> productcategorie waarbinnen product valt.
<merk> merk van het product.
<type> type van het product.
<hits> totaal aantal reviews van het product.
<section>“review_link_id” het Id/Uid van de review.
<section>“review_link” link naar de gehele review.
<section>“approved” review goedgekeurd door Kieskeurig.nl
<section>“recommend” review aanbevolen door andere consumenten
<text> de opgemaakte reviewtekst.
<tekst_raw> de originele reviewtekst
<date> de datum wanneer de review is geschreven.
<name> de nickname van de reviewer.
<title> de titel van de review
<cijfer> Totaalcijfer van de review.
<inbezit> Tijd dat de reviewer het betreffende product in bezit heeft.
<pros><pro> pluspunten
<cons><con> minpunten

Vragen

Heb je vragen? Neem dan contact op met: datamanagement@kieskeurig.nl.

Meer informatie/technische documentatie