Integratie Whitelabel winkelreviews op eigen site

[view this text in English]

Om de winkelreviews 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 winkelreviews op jouw website, gebruik je onderstaande REST-call. Deze REST-call geeft een XML met alle reviews van een specifieke winkel en het totale beoordelingscijfer.

http://rest-ext.kieskeurig.nl/nl/shop.nsf/reviews?shopid=[shop-id]&reviewtype=all&_version=3.10&_token=[token]

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
shop_id	uniek shop-id	ja
token	key	ja

Verklaring van de parameters:

[token]	unieke toegangscode om toegang te krijgen tot de REST-call
[shop_id]	het id/uid van de shop

Wat neem je over uit de REST-call

De REST-call geeft een XML, waarvan de volgende velden getoond moeten worden om de reviews van Kieskeurig.nl op de juiste manier op jouw website te kunnen plaatsen:

<text> (volledig)
<name>
<date>
<gender> (indien gevuld)
<cijfer>
<section>“review_link”

Voorbeeld XML

<resultset version="7.4.0.0" reqver_maj="3" reqver_min="10" build_date="2017-03-01 12:14">
<dartcode>homepage</dartcode>
<stirgroup>home</stirgroup>
<stircode>ecommerce</stircode>
<stir4code/>
<reviewspage>https://www.kieskeurig.nl/alternate/winkelbeoordeling/B78D3425E5F554FCC1256C84003BFBE4</reviewspage>
<ShopInfoRecord online="true">
<ShopID>B78D3425E5F554FCC1256C84003BFBE4</ShopID>
<ShopIntro>
<ShopName>Alternate</ShopName>
<ShopLogo>https://media.kieskeurig.nl/images/01/32/87/b2/51cd/4c60/8c96/52dd7b6775c7/orig.png</ShopLogo>
<ShopImage/>
<ShopIntroText>Alternate is van oudsher één van de grotere online leveranciers van computers, computercomponenten en multimediaproducten in Europa. … Vanuit Nederland is in 2007 ook in België (Aartselaar) een vestiging gestart, met vergelijkbaar succes.</ShopIntroText>
<ShopTotalReviewRating count="50">
<label>Beoordeling</label>
<value>6,5</value>
</ShopTotalReviewRating>
</ShopIntro>
</ShopInfoRecord>
<hits>919</hits>
<page>1</page>
<section name="review" id="6017352" review_link_id="6017352" review_link="https://www.kieskeurig.nl/alternate/winkelbeoordeling/uniek/adele_m/b78d3425e5f554fcc1256c84003bfbe4/6017352" approved="Y" recommend="Y">
<site>NL</site>
<text>ik had n muis en toetsenbord besteld , alleen hadden ze de verkeerde toetsenbord gestuurd , maar zonder problemen kon dit omgeruild worden. als ik weer wat nodig mocht hebben zal ik hier zeker weer bestellen.</text>
<title>goede service</title>
<location physical="false"/>
<date dt="2017-03-02T13:53:33">02-03-2017</date>
<name>adele m</name>
<form>review</form>
<cijfer>7</cijfer>
<stericon>ster30_red</stericon>
<part>
<label>Gemak</label>
<value>8</value>
</part>
<part>
<label>Service</label>
<value>8</value>
</part>
<part>
<label>Levering</label>
<value>8</value>
</part>
<part>
<label>Levertijd</label>
<value>6</value>
</part>
<part>
<label>Afleverservice</label>
<value>10</value>
</part>
<part>
<label>Verzendkosten</label>
<value>8</value>
</part>
<part>
<label>Retourproces</label>
<value>10</value>
</part>
<part>
<label>Klantenservice</label>
<value>8</value>
</part>
<part>
<label>Betaalmogelijkheden</label>
<value>8</value>
</part>
<part>
<label>Gebruiksvriendelijkheid site</label>
<value>8</value>
</part>
</section>

Verklaring(relevante) XML-nodes

node	verklaring
<reviewspage>	link naar de reviewoverzichtpagina van de shop.
<ShopTotalReviewRating> “count”	totaal aantal shopreviews die meetellen voor de beoordeling
<ShopTotalReviewRating> <label> Beoordeling</label> <value>	totaal cijfer voor de review
<hits>	totaal aantal reviews
<section>“review_link_id”	het Id/Uid van de review
<section>“review_link”	link naar de gehele review op kieskeurig.nl
<section>“approved”	Y = review goedgekeurd door Kieskeurig.nl
<section>“recommend”	Y = review aanbevolen door andere consumenten
<text>	de opgemaakte reviewtekst
<title>	titel van de review
<date>	de datum wanneer de review is geschreven
<name>	de gebruikersnaam van de reviewer
<title>	de titel van de review
<cijfer>	totaalcijfer van de review
<part> <label>	deel-beoordelingscriteria
<part> <value>	deel-beoordelingscijfer
<pros><pro>	pluspunten
<cons><con>	minpunten

Vragen

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