API-Token erstellen und verwenden

Überblick

Um die API nutzen zu können, benötigen Sie einen persönlichen API-Token. Dieser Token authentifiziert Ihre Anfragen und ermöglicht es Ihnen, Artikel zu erstellen, zu bearbeiten und abzurufen.

Token erstellen

Schritt 1: Zum Token-Manager navigieren

Navigieren Sie zur API-Token Verwaltung, um Ihre Tokens zu verwalten.

Alternativ:

1. Melden Sie sich in Ihrem Account an
2. Klicken Sie auf Ihr Profilbild oder Ihren Namen
3. Wählen Sie "API-Tokens" aus dem Menü

Schritt 2: Neuen Token erstellen

1. Geben Sie einen aussagekräftigen Namen für Ihren Token ein (z.B. "Mein Entwicklungs-Token")
2. Klicken Sie auf "Token erstellen"
3. Wichtig: Kopieren Sie den angezeigten Token sofort und speichern Sie ihn sicher

Hinweis: Der Token wird nur einmal angezeigt. Wenn Sie ihn verlieren, müssen Sie einen neuen Token erstellen.

Token-Limit

Sie können maximal 3 aktive Tokens gleichzeitig haben. Falls Sie das Limit erreicht haben, müssen Sie zunächst einen bestehenden Token löschen.

Token verwenden

Authentication Header

Fügen Sie Ihren Token in jede API-Anfrage als Bearer-Token im Authorization-Header ein:

Authorization: Bearer IHR_API_TOKEN_HIER

Beispiel mit cURL

curl -X GET https://ihre-domain.de/api/user \
  -H "Authorization: Bearer IHR_API_TOKEN_HIER" \
  -H "Accept: application/json"

Beispiel mit JavaScript (fetch)

fetch('https://ihre-domain.de/api/user', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer IHR_API_TOKEN_HIER',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Beispiel mit PHP

$ch = curl_init('https://ihre-domain.de/api/user');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer IHR_API_TOKEN_HIER',
    'Accept: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

Token verwalten

Token löschen

Wenn Sie einen Token nicht mehr benötigen oder vermuten, dass er kompromittiert wurde:

1. Gehen Sie zur API-Token Verwaltung
2. Klicken Sie auf "Löschen" neben dem entsprechenden Token
3. Bestätigen Sie die Löschung

Sicherheitshinweis: Löschen Sie Tokens, die Sie nicht mehr verwenden, um die Sicherheit Ihres Accounts zu erhöhen.

Best Practices

Token-Sicherheit

• Niemals Token in öffentlichen Repositories (GitHub, GitLab etc.) committen
• Verwenden Sie Umgebungsvariablen für Token-Speicherung
• Erstellen Sie separate Tokens für verschiedene Anwendungen
• Rotieren Sie Tokens regelmäßig (alle 3-6 Monate)

Fehlerbehandlung

Wenn Sie einen 401 Unauthorized Fehler erhalten:

• Überprüfen Sie, ob der Token korrekt eingefügt wurde
• Stellen Sie sicher, dass kein Leerzeichen vor oder nach dem Token ist
• Prüfen Sie, ob der Token noch existiert (nicht gelöscht wurde)
• Erstellen Sie ggf. einen neuen Token

Nächste Schritte

Nachdem Sie Ihren Token erstellt haben, können Sie:

• Kategorie-IDs abrufen für die Artikel-Erstellung
• Artikel erstellen über die API
• Artikel für Unternehmen veröffentlichen