Handleiding

Aan de slag met API

Onder API requests vind je een overzicht van de Catalog calls. Bij iedere call kan je informatie vinden over gebruik en een voorbeeld van het response verkrijgen.

Stap 1 – Aanmelden op het Affiliate marketing platform

Door je aan te melden op het developer center kun je alles rondom de bol.com API raadplegen en toegang aanvragen.

Stap 2 – API toegang aanvragen

Vanuit je eigen affiliate account kan je toegang aanvragen tot de bol.com Open API. Je ontvangt dan een zogenaamde Access key (in V3 van de Open API heb je nog een Secret key nodig welke we verstrekken). Op basis van deze twee codes kun je gebruik maken van de Open API. Bij de aanvraag vul je ook enkele persoonsgegevens in, die bol.com vastlegt in het registratiesysteem. Dit doen wij zodat we direct met je kunnen communiceren en daarnaast om misbruik van de Open API te voorkomen. Zodra jouw toegangsaanvraag is goedgekeurd (enkele dagen), brengen we je hiervan op de hoogte en vind je jouw toegangsgegevens in je profiel.

Stap 3 – Documentatie en codevoorbeelden

Als de toegang eenmaal geregeld is, raden we je aan om de handleiding te lezen.

Stap 4 – Je eigen toepassing maken

Bol.com stimuleert graag jouw creativiteit bij het maken van je eigen toepassing. Hierbij dien je echter wel rekening te houden met de algemene voorwaarden van bol.com voor het gebruik van de API.

Enkele tips voor toepassingen:

  • Plaats je toegangskey niet in apps die op een mobile device staan om misbruik van jouw key te voorkomen. Het is beter om deze op bijvoorbeeld een eigen omgeving in eigen beheer te plaatsen.
  • Plaats je toegangskey niet in openbare code zoals javascript of html om misbruik te voorkomen.
  • Het moet duidelijk zijn voor de eindgebruiker dat bol.com niet de eigenaar of opdrachtgever van jouw toepassing is. Houd hierbij rekening me de merkvoorwaarden. Deze vind je terug in de algemene voorwaarden Uiteraard is het wel toegestaan om te melden dat het om producten van bol.com gaat.
  • Ga slim om met het maken van calls naar de Open API, om niet over je toegestane limiet heen te gaan. Gebruik caching om onnodige dubbele calls te voorkomen en laadtijd voor jouw eindgebruiker te beperken

Over de Open API

De bol.com RESTful Open API biedt de volgende mogelijkheden voor gebruikers:

  • Zoeken in de catalogus naar producten
  • Nieuwe producten, van bol.com, externe partners en tweedehands producten
  • Raadplegen van toplijsten zoals best verkocht, te reserveren
  • Sorteren van resultaten uit een zoekopdracht
  • Ophalen van de bol.com categorieboom
  • Toepassen van filters op een zoekopdracht
  • Specifiek zoeken binnen zelf op te geven categorieën en filteringen
  • Product aanbevelingen ophalen. Dit is vergelijkbaar met “Anderen bekeken ook”.

Alle mogelijkheden kan je vinden in de API documentatie.

Geld verdienen

Bij het maken van een toepassing op basis van de API kan je gebruik maken van het bol.com Affiliate programma. Als er dan producten op bol.com verkocht worden via jouw partnerlink, verdien je commissie over alle producten van de bestelling door die bezoeker.

Gebruik

Het gebruik van de Open API is gebonden aan voorwaarden we wijzen we je graag op de volgende gebruiksvoorwaarden:

  • Respecteer de eindgebruiker van jouw applicatie. Het is niet toegestaan om op enige manier de informatie van de API te manipuleren of zodanig te presenteren dat dit voor de eindgebruiker onjuistheden oplevert.
  • Ga bewust om met het aantal requests dat je doet. Er geldt een maximum van 1200 per uur en overschrijding hiervan kan resulteren in het afsluiten van je toegang.
  • Je bent als developer zelf verantwoordelijk voor alles wat er vanuit jouw toegangskey wordt gedaan. Zorg er dus voor dat deze nooit in andermans handen komt of op enige manier misbruikt wordt.

Security

Het is niet toegestaan om je persoonlijke toegangskey te delen met anderen, om misbruik te voorkomen. Gebruik dus geen openbare code zoals javascript om je toegangskey te bewaren. Wij raden je dan ook aan om hiervoor maatregelen te treffen (zoals een eigen proxy oplossing te gebruiken voor het door-leiden van het verkeer).

Ondersteuning en support

Wat betreft support biedt bol.com je deze omgeving met informatie, handleidingen, voorbeelden en nieuws. Kom je er met al deze informatie toch niet uit, kun je je vragen ook mailen naar partner@bol.com.