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.
Aanmaken van Client credentials
Met de Client credentials kun je je authenticeren bij de bol Retailer API. Client credentials zijn een soort gebruikersnaam en wachtwoord voor de API. Hieronder vind je de stappen om Client credentials aan te maken:
API-instellingen openen
Log in in het bol verkoopaccount, open de instellingenpagina en ga onder het kopje ‘Diensten’ naar ‘API Instellingen’.
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.
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 etc.), vul dan de naam in van deze partij. Klik na het invullen van de naam op ‘Aanmaken’.
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.
Gebruik je een integratiepartner? Vul daar je Client credentials in.
Wanneer je gebruik maakt van een integratiepartner/3de 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.
Tip!
Bij onze vorige API werden Client Credentials nog API Keys genoemd. Het kan voorkomen dat jouw integratiepartner nog ‘API Keys’ vermeldt in plaats van Client credentials. Dit is geen probleem, je kunt dan gewoon onder API Keys je Client credentials invullen.
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 account.
Bij vertrouwde derde partijen volg je de onderstaande stappen wanneer je een koppeling met bol opzet.
Ga naar de website van de derde partij.
Wanneer je een koppeling met bol opzet, word je automatisch doorgestuurd naar de bol inlogpagina. Vul de inloggegevens in van je bol verkoopaccount en klik op ‘Inloggen’.
Toegang verlenen aan derde partij
Na het inloggen krijg je een vervolg scherm waarbij je toestemming dient te geven aan de partij om je bol account te koppelen.
Klik op de knop ‘Toestaan’ om toegang te verlenen . Daarna word je teruggestuurd naar de website van de derde partij.
Authorized parties bekijken
In het bol 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.
Maak je op een gegeven moment geen gebruik meer van de derde partij?
Verwijder in het bol verkoopaccount onder het kopje ‘Authorized parties voor de Retailer API’ dan deze partij.