Authentifizierung

Ihre Daten sind uns wichtig, deshalb erfordert jeder API-Aufruf eine gültige Authentifizierung. So stellen wir sicher, dass nur Sie auf Ihre Geschäftsdaten zugreifen kannst.

Zwei Wege zur Authentifizierung

Wir bieten Ihnen zwei Möglichkeiten, je nachdem, was Sie erreichen möchtest:

API-Schlüssel

API-Schlüssel sind der einfachste Weg, unsere API zu nutzen. Ein Schlüssel gehört immer zu Ihrem Konto und hat Zugriff auf alle Ihre Geschäftsdaten.

Schlüssel erstellen

Schlüsseltypen

Bearer Token Format

Sende den API-Schlüssel im Authorization-Header:

curl -X GET "https://buchhaltgenie.at/api/v1/invoices" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

curl -X GET "https://buchhaltgenie.at/api/v1/invoices" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

const response = await fetch('https://buchhaltgenie.at/api/v1/invoices', {
  headers: {
    'Authorization': `Bearer ${process.env.BUCHHALTGENIE_API_KEY}`,
    'Content-Type': 'application/json',
  },
});
 
const data = await response.json();

import requests
import os
 
response = requests.get(
    'https://buchhaltgenie.at/api/v1/invoices',
    headers={
        'Authorization': f'Bearer {os.environ["BUCHHALTGENIE_API_KEY"]}',
        'Content-Type': 'application/json',
    }
)
 
data = response.json()

<?php
$apiKey = getenv('BUCHHALTGENIE_API_KEY');
 
$ch = curl_init('https://buchhaltgenie.at/api/v1/invoices');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
$data = json_decode($response, true);
?>

OAuth 2.0

OAuth 2.0 eignet sich für Anwendungen, die im Namen verschiedener BuchhaltGenie-Benutzer agieren. Benutzer autorisieren Ihre App, auf ihre Daten zuzugreifen - ohne Ihnen ihr Passwort zu verraten.

Authorization Code Flow

GET https://auth.buchhaltgenie.at/oauth/authorize?
  client_id=YOUR_CLIENT_ID&
  redirect_uri=https://deine-app.at/callback&
  response_type=code&
  scope=invoices:read invoices:write&
  state=RANDOM_STATE_STRING

curl -X POST "https://auth.buchhaltgenie.at/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "code=AUTHORIZATION_CODE" \
  -d "redirect_uri=https://deine-app.at/callback"

curl -X GET "https://buchhaltgenie.at/api/v1/invoices" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Verfügbare Scopes

Sicherheits-Best-Practices

Schlüssel sicher aufbewahren

// Umgebungsvariable verwenden
const apiKey = process.env.BUCHHALTGENIE_API_KEY;

// Niemals im Code speichern!
const apiKey = "sk_live_xxx";

Weitere Empfehlungen

• Rotiere Schlüssel regelmäßig - Erstelle alle 90 Tage neue Schlüssel
• Verwende separate Schlüssel - Ein Schlüssel pro Anwendung/Umgebung
• Überwache die Nutzung - Prüfe regelmäßig die API-Zugriffsprotokolle
• Test-Schlüssel für Entwicklung - Nutze sk_test_ Schlüssel für Tests

Fehlerbehandlung

const response = await fetch('https://buchhaltgenie.at/api/v1/invoices', {
  headers: {
    'Authorization': `Bearer ${apiKey}`,
  },
});
 
if (response.status === 401) {
  // API-Schlüssel ungültig oder abgelaufen
  console.error('Authentifizierung fehlgeschlagen - bitte API-Schlüssel prüfen');
}
 
if (response.status === 403) {
  // Keine Berechtigung für diese Ressource/Aktion
  console.error('Zugriff verweigert - fehlende Berechtigung');
}

Häufige Fragen

Nächste Schritte

• Sicherheitsrichtlinien - Weitere Sicherheitsempfehlungen
• Rate Limits - Nutzungslimits verstehen
• API Endpunkte - Beginne mit der Integration