24-06-2014 Open API V4 stable

Geplaatst op 24 juni 2014 door bol.com — Geen Reacties ↓

Versie 4 van de bol.com Open API is als stable versie live. Dat betekent dat we je adviseren deze versie ook te gaan gebruiken. Mocht je dus V3 van de Open API gebruiken, dan is het raadzaam om over te gaan op de nieuwe versie, er zitten een hoop verbetringen in! We blijven V3 uiteraard nog wel ondersteunen de komende tijd.

Belangrijkste verbeteringen

We hebben goed geluisterd naar jullie feedback en hebben ook aan de achterkant performance verbeteringen doorgevoerd. De verbeteringen aan de voorkant zijn:

JSON support
lichtere responses en een response format waar meeste ontwikkelaars tegenwoordig mee werken. JSON response is default. Maar je kan dit in de url als parameter meegeven (format=xml) of als accept-header.
Met één simpele apikey in de call verwerkt krijg je een JSON of XML response
geen ingewikkelde signing meer, maar één key.
Veilig data verkrijgen en sturen over HTTPS
hiermee blijft de apikey ook uit het zicht bij verkeer tussen je toepassing en api.bol.com
Nieuwe calls:
- Alleen offers en aanbieders op halen van een product
  prijswijzigingen kunnen op deze manier gecontroleerd worden
- Specifieker kunnen zoeken op auteur, artiest, titel, merk, songtitel, acteur of regisseur
  hiermee kan je gerichter zoeken op bepaalde zoekvelden
- Basket en Wishlist calls ism auth calls
  om bijvoorbeeld je winkelwagentje of verlanglijstje over verschillende devices te kunnen synchroniseren. Voor de auth calls dien je een aanvraag te doen per e-mail.
- Vinden van gerelateerde producten
  Met deze nieuwe API call heb je de mogelijkheid om mogelijke accessoires van een product terug te krijgen en kan je zien of er meer producten zijn uit dezelfde familie. Neem bijvoorbeeld een zwarte iPhone 16GB, dan kan je zien dat er ook een witte iPhone 16GB of een zwarte iPhone 32GB is.

Cosmetische wijzigingen

We hebben een aantal cosmetische wijzigingen doorgevoerd in V4, waaronder:

Query parameters altijd lowercase (bijv. includeattributes of sort)
Generieke offset en limit queryparameter (?offset=10&limit=20)
Een komma is de nieuwe separator voor meerdere productid’s, categoryid’s, dataoutput (categories,refinements,products)
Het nieuwe subdomein is api.bol.com ipv openapi.bol.com
“rest” is uit de aanroep url verdwenen
Multiselectable refinements,
Refinements kan je nu ook als “multiSelect” gebruiken als je deze bijvoorbeeld met een checkbox/multi-select optie wilt tonen in je toepassing. Met multiselect kan je meerdere refinements combineren in één request binnen dezelfde refinement groep.

Wijzigingen tov V4 beta versie

Nieuwe indicator “bestOffer”

Het aantal offers en aanbieders bij bol.com wordt steeds groter. Vanaf nu geven we bij elk product aan welke offer we zelf tonen in de winkel en doorsturen naar externe kanalen. Dit offer is voorzien van de indicator “bestOffer” in de Open API. Dit heeft invloed op zowel Versie 3 als Versie 4 van de Open API. Voorheen gaf de Open API onder de Offers>Offer tag in de product call het bol.com seller offer als eerste weer (als deze aanwezig was). Nu is dat ook niet meer de default voor het eerste resultaat. Je zou het offer met de tag “bestOffer” moeten afvangen voor de prijs. Mocht je het bol.com seller offer willen, dan dien je te zoeken op seller>id: 0. Voor list call krijg is de default het bestOffer, dus ook al is er een bol.com seller offer deze staat niet in de list result. Alleen als je queryparameter “offers=bolcom” of “offers=all” toevoegt aan de list call.

Zakelijke verkoper informatie

Seller rating (De beoordelingsscore is het gemiddelde cijfer dat kopers aan de verkoper hebben gegeven in de laatste 3 maanden. Wanneer er de laatste 3 maanden minder dan vijf beoordelingen zijn gegeven, is de score een gemiddelde van alle beoordelingen.)
RecentReviewCounts (aantal reviews voor deze seller van de afgelopen 3 maanden)
AllReviewsCounts (het totaal aantal reviews voor deze seller over de gehele lifetime van de verkoper)