Zum Hauptinhalt springen

API-Authentifizierung

So authentifizierst du dich an der Klar API per Bearer-Token — inkl. curl- und TypeScript-Beispiel.

Verfasst von Frank Birzle

Klar nutzt Bearer-Authentifizierung. Übergib deinen Token im Authorization-Header jeder Anfrage:

Authorization: Bearer <token>

Beispiel — curl:

curl -X POST \
--data "@/path/to/filename" \
-H "Authorization: Bearer <token>" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
"https://open-api.durchsichtig.xyz/12.2022/orders/validate"

Beispiel — TypeScript:

fetch('https://open-api.durchsichtig.xyz/12.2022/orders/validate', {
method: 'POST',
headers: {
'Authorization': 'Bearer <token>',
'Accept': 'application/json',
'Content-Type': 'application/json'
},
body: [...]
});

💡 Gut zu wissen: Um einen Token für die Klar API oder Klar Returns zu erzeugen, musst du zuerst eine Datenquelle vom Typ „Klar Api" oder „Klar Returns" verbinden.

Schritt 1: Die Datenquelle verbinden

Bevor du einen Token erzeugen kannst, musst du eine Klar-API- oder Klar-Returns-Datenquelle verbinden.

  1. Gehe zu EinstellungenStore-Konfigurator → dein Store → Datenquellen

  2. Klicke auf Connect Data Source

  3. Wähle im Modal Klar API oder Klar Returns

  4. Gib der Datenquelle einen Namen (z.B. Order API) und speichere

Schritt 2: Deinen Token kopieren

  1. Öffne die gerade erstellte Datenquelle

  2. Gehe zum Tab Access Token

  3. Klicke auf Copy Token

Dein Token ist ein JWT und sieht so aus:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhU291cmNlSWQiOiIkS0lEOkFHR19JRDoxYmEyYWY4OC0zODZiLTQyZjQtODE2Ni04NDVjNjc4NTEwOWE  
6ZGYzOTc2MzAtYTdjOC00ODI3LWJhNjUtN2U0N2FjOGRjNmM5OiQiLCJ0eXBlIjoia2xhci1pbXBvcnQtYXBpIiwidmVyc2lvbiI6MCwiaWF0IjoxNjc2ODg0Mjg4
LCJhdWQiOiJrbGFyLWltcG9ydC1hcGkiLCJpc3MiOiJrbGFyIiwic3ViIjoiJEtJRDpBR0dfSUQ6MWJhMmFmODgtMzg2Yi00MmY0LTgxNjYtODQ1YzY3ODUxMDlhOm
RmMzk3NjMwLWE3YzgtNDgyNy1iYTY1LTdlNDdhYzhkYzZjOTokIn0.dPsPZ8RoCPikjNJFc_4FBfhaqN0a9Won19Rj4puz6c8

Hat dies deine Frage beantwortet?