API keys

Als je je Bol.com verkoopaccount wil koppelen aan Buckles, dan hebben we je API keys nodig. API keys zijn inloggegevens voor onze integratie, waarmee wij verbinding kunnen leggen met jouw Bol.com shop. Deze gegevens voer je eenmalig in, en daarna kunnen we direct aan de slag.

Hoe zoek je je API keys op?

Je Bol.com API keys bestaan uit een Client ID en een Client Secret van de Bol.com Retailer API. Deze vind je op de volgende manier:

1. Log in op je Bol.com account en ga naar 'Instellingen'.

Documentation Image 1


2. Ga naar 'API instellingen' onder het kopje 'Diensten'.

Documentation Image 3


3. Voer contactgegevens van een technisch contact in, als je dat al niet hebt gedaan. Dit kan jij zelf zijn, of een technische partner die je webshop onderhoudt. Je hoeft hier geen contactgegevens van Buckles in te voeren, want wij hebben zelf contact met Bol.com over eventuele storingen.

Documentation Image 5


4. Ga naar het kopje 'Client credentials' en klik hier op 'Aanmaken'.

Documentation Image 7


5. Voer een naam in voor je credentials waaraan je de set inloggegevens eventueel later kan herkennen. 'Buckles' is een uitstekende naam. Druk daarna op 'Ja, voeg toe'.

Documentation Image 9


6. Je API keys zijn nu direct aangemaakt, en je krijgt nu direct je Client ID te zien. Klik op 'Toon secret' om ook je Client Secret te tonen.

Documentation Image 11


Je Client ID en Client Secret zijn allebei lang en hoofdlettergevoelig, dus kopieer ze beiden naar je klembord of plak ze direct in de Buckles Bol.com onboarding.

Voorbeeld van Client ID

b9e44ad0-32fa-4gv7-9705-c107d8ceg80c

Voorbeeld van Client Secret

d3u2MrLqPqp32j9TTVZP3sw6L-8Z5sZ-THJF2kt5yfRyZGwoK81pGVuse6p33xV81vR8rAqnOWtpGbJUdQYgNw

Hoelang zijn mijn API keys geldig?

Zolang je op Bol.com je API keys niet weggooit of op een andere manier ongeldig maakt, blijven deze bewaard in je Buckles account en hoef je deze maar één keer in te voeren. Mocht je op Bol.com je API keys verwijderen, dan verliezen wij de verbinding met je Bol.com shop en kunnen we geen data meer doorsturen. Als dit het geval is krijg je hier een notificatie van Buckles van.