Zugang mit API Client Credentials erhalten
Um Zugang zur API zu erhalten, benötigen Sie Client Credentials. Auf dieser Seite finden Sie weitere Informationen zu Client Credentials und deren Erstellung. Einige unserer Gold-, Silber- und Bronze-Partner sind an unser vereinfachtes Authentifizierungsverfahren angeschlossen. Am Ende dieser Seite erfahren Sie mehr darüber, wie das Authentifizierungsverfahren bei diesen Drittanbietern funktioniert.
Erstellung von Client Credentials
Mit den Client Credentials können Sie sich bei der bol Retailer API authentifizieren. Client Credentials sind eine Art Benutzername und Passwort für die API. Nachfolgend finden Sie die Schritte zur Erstellung von Client Credentials:
API-Einstellungen öffnen
Melden Sie sich im bol Verkäuferkonto an, öffnen Sie die Einstellungsseite und gehen Sie unter der Überschrift ‚Dienste‘ zu ‚API-Einstellungen‘.
Kontaktdaten Technik eingeben und auf ‘Speichern’ klicken
Diese Kontaktdaten werden verwendet, um über wichtige Updates und Neuigkeiten rund um die API zu informieren. Stellen Sie daher sicher, dass Sie die Kontaktdaten der Person eingeben, die technisch für Ihre API-Verbindung verantwortlich ist.
Klicken Sie unter ‘Client credentials Retailer API’ auf ‘Erstellen’
Geben Sie im Textfeld einen Namen für die Credentials ein. Verwenden Sie vorzugsweise einen Namen Ihrer internen oder externen Software. Wenn Sie einen Drittanbieter für die API nutzen (einen Integrationspartner, Fulfillment-Partner etc.), geben Sie den Namen dieses Anbieters ein. Klicken Sie nach Eingabe des Namens auf ‚Erstellen‘.
Die Client Credentials wurden nun erstellt.
Die Client ID wird automatisch auf dem Bildschirm angezeigt. Wenn Sie auf ‚Secret anzeigen‘ klicken, öffnet sich ein Pop-up mit dem Client Secret.
Nutzen Sie einen Integrationspartner, geben Sie Ihre Client credentials ein
Wenn Sie einen Integrationspartner/Drittanbieter nutzen, geben Sie die Client Credentials in dessen System ein.
Wenn Sie sich mit mehreren Drittanbietern verbinden möchten, müssen Sie für jeden Anbieter separate Client Credentials erstellen. Wenn Sie die Zusammenarbeit mit einem Drittanbieter beenden, können Sie die Client Credentials dieses Anbieters auch einfach wieder entfernen.Erstellen Sie selbst eine API-Verbindung? Hier finden Sie alles über die Authentifizierungs-Flows und Client Credentials.
Tipp!
Bei unserer vorherigen API wurden Client Credentials noch API Keys genannt. Es kann vorkommen, dass Ihr Integrationspartner immer noch ‚API Keys‘ anstelle von Client Credentials erwähnt. Das ist kein Problem, Sie können Ihre Client Credentials einfach unter API Keys eingeben.
Vereinfachtes Authentifizierungsverfahren für autorisierte Parteien
Bei einigen vertrauenswürdigen Drittanbietern müssen Sie keine Client Credentials in deren Anwendung oder auf deren Website eingeben. Sie müssen lediglich einmal pro Jahr von deren Anwendung aus die Erlaubnis zum Datenaustausch mit Ihrem bol Konto erteilen.
Bei vertrauenswürdigen Drittanbietern befolgen Sie die untenstehenden Schritte, wenn Sie eine Verbindung mit bol einrichten.
Gehen Sie auf die Website des Drittanbieters.
Wenn Sie eine Verbindung mit bol einrichten, werden Sie automatisch zur bol Anmeldeseite weitergeleitet. Geben Sie die Anmeldedaten Ihres bol Verkäuferkontos ein und klicken Sie auf ‚Anmelden‘.
Zugriff an Drittanbieter gewähren
Nach der Anmeldung erhalten Sie einen Folgebildschirm, auf dem Sie dem Anbieter die Erlaubnis erteilen müssen, Ihr bol Konto zu verbinden.
Klicken Sie auf die Schaltfläche ‚Zulassen‘, um den Zugriff zu gewähren. Danach werden Sie zur Website des Drittanbieters zurückgeleitet.
Autorisierte Parteien ansehen
Im bol Verkäuferkonto finden Sie unter der Überschrift ‚Autorisierte Parteien für die Retailer API‘ nun den Namen des Drittanbieters.
Hier sehen Sie auch, wann die Genehmigung abläuft: Die Genehmigung ist nämlich ein Jahr gültig und muss danach erneut erteilt werden. Glücklicherweise senden die meisten autorisierten Parteien eine Benachrichtigung vor dem Ablaufdatum, um Sie daran zu erinnern.
Nutzen Sie den Drittanbieter irgendwann nicht mehr?
Entfernen Sie im bol Verkäuferkonto unter der Überschrift ‚Autorisierte Parteien für die Retailer API‘ diesen Anbieter.