Toegang krijgen met API Client credentials

Om toegang te krijgen tot de API heb je Client credentials nodig. Op deze pagina vind je meer informatie over Client credentials en het aanmaken hiervan. Sommige van onze gold, silver en bronze partners zijn aangesloten op ons vereenvoudigde authenticatieproces. Onderaan deze pagina lees je meer over hoe het authenticatieproces werkt bij deze derde partijen.

Met de Client credentials kun je je authenticeren bij de bol.com Retailer API. Client credentials zijn een soort gebruikersnaam en wachtwoord voor de API. Hieronder vind je de stappen om Client credentials aan te maken:

1. Log in in het bol.com verkoopaccount, open de instellingenpagina en ga onder het kopje ‘Diensten’ naar ‘API Instellingen’.

2. Vul de contactgegevens in van je technisch contactpersoon en klik op ‘Opslaan’.

Deze contactgegevens worden gebruikt voor het informeren over belangrijke updates en nieuws rondom de API. Wees er daarom zeker van dat je de contactgegevens invult van de persoon die technisch verantwoordelijk is voor je API-koppeling.

3. Klik onder het kopje ‘Client credentials voor de Retailer API’ op ‘Aanmaken’.

Geef in het tekstveld een naam op voor de credentials. Gebruik bij voorkeur een naam van je interne of externe software. Wanneer je gebruik maakt van een derde partij voor de API (een integratiepartner, fulfillmentpartij bijvoorbeeld), vul dan de naam in van deze partij. Klik na het invullen van de naam op ‘Aanmaken’.

4. De Client credentials zijn nu aangemaakt.

De Client ID wordt automatisch in het scherm getoond. Wanneer je op ‘Toon secret’ klikt, wordt er een pop-up geopend met daarin de Client secret.

5. Wanneer je gebruik maakt van een integratiepartner/derde partij vul je in hun systeem de Client credentials in.

Als je wilt koppelen met meerdere derde partijen, dan dien je voor iedere partij aparte Client credentials aan te maken. Wanneer je stopt met een derde partij kun je de Client credentials van deze partij ook gemakkelijk weer verwijderen.

Bouw je zelf een API koppeling? Hier vind je alles over de authenticatie flows en Client credentials.

Vereenvoudigd authenticatieproces authorized parties

Bij sommige vertrouwde derde partijen hoef je geen Client credentials in te vullen in hun applicatie of website. Je hoeft enkel een keer per jaar vanuit hun applicatie toestemming te geven om gegevens uit te wisselen met je bol.com account.

Bij vertrouwde derde partijen volg je de onderstaande stappen wanneer je een koppeling met bol.com opzet.

1. Ga naar de website van de derde partij.

Wanneer je een koppeling met bol.com opzet, word je automatisch doorgestuurd naar de bol.com inlogpagina. Vul de inloggegevens in van je bol.com verkoopaccount en klik op ‘Inloggen’.

2. Na het inloggen krijg je een vervolg scherm waarbij je toestemming dient te geven aan de partij om je bol.com account te koppelen.

Klik op de knop ‘Toestaan’ om toegang te verlenen . Daarna word je teruggestuurd naar de website van de derde partij.

3. In het bol.com verkoopaccount vind je onder het kopje ‘Authorized parties voor de Retailer API’ nu de naam van de derde partij.

Hier zie je ook wanneer de toestemming verloopt: De toestemming is namelijk geldig voor een jaar en moet daarna opnieuw gegeven worden. Gelukkig sturen de meeste authorized parties een melding voor de verloopdatum om je hieraan te herinneren.

4. Maak je op een gegeven moment geen gebruik meer van de derde partij?

Verwijder in het bol.com verkoopaccount onder het kopje ‘Authorized parties voor de Retailer API’ dan deze partij.

Ook handig

Onderwerpen en tips op een rijtje

Werking zelf automatiseren

Zelf automatiseren betekent dat je, zonder tussenkomst van een intermediair, een directe koppeling met bol.com maakt. Lees op deze pagina hoe je dit doet.

Werking automatiseren via een derde partij

Gebruik maken van integratiepartners die alle gangbare koppelingen tussen bol.com en een webshop al hebben gemaakt en dit op maatwerk doen? Zo regel je dat.

Wat is de Retailer API lifecycle precies?

Regelmatig worden er nieuwe versies van de Retailer API gelanceerd om jou efficiënter te laten werken. Lees meer wat dit inhoudt.