TixFinDocs
API-Integration

API-Authentifizierung

Ihre API-Anfragen absichern

4 Min. Lesezeit

So authentifizieren Sie Ihre Anfragen an die Partner-API sicher.

Authentifizierungsverfahren

Die Partner-API nutzt API-Schlüssel im Format prefix.secret. Jeder Schlüssel gilt für ein Projekt und für eine oder mehrere Endpunktgruppen (events.read, ticket_catalog.read, tickets.read, orders.read). Eine Anfrage gelingt nur, wenn der Schlüssel die Gruppe des Endpunkts trägt und das Projekt diese Gruppe aktiviert hat. Schalten Sie eine Gruppe ab, verlieren also alle Schlüssel den Zugriff darauf, ohne dass Sie einen widerrufen müssen.

Das Präfix ist öffentlich und kennzeichnet den Schlüssel in Logs und im Zugriffsprotokoll; das Geheimnis wird nur als Hash mit geheimem Schlüssel (HMAC) gespeichert und lässt sich nicht wiederherstellen.

Senden Sie den Schlüssel in einem der beiden Header:

GET /api/partner/projects/{projectId}/events
Host: beta-rest-api.tixfin.com
X-API-Key: YOUR_API_KEY

oder als Bearer-Token:

GET /api/partner/projects/{projectId}/events
Host: beta-rest-api.tixfin.com
Authorization: Bearer YOUR_API_KEY

Die Partner-API hat keinen getrennten Test- und Live-Modus – ein Schlüssel gilt für genau ein Projekt und nur für die Endpunktgruppen, die Sie ihm geben.

API-Schlüssel erhalten

  1. Melden Sie sich mit Zwei-Faktor-Authentifizierung bei beta.tixfin.com an
  2. Wählen Sie das Projekt und öffnen Sie das Kontomenü → Konto → Integrationen (unter Abrechnung)
  3. Aktivieren Sie die Endpunktgruppen, die dieses Projekt freigeben soll
  4. Klicken Sie auf API-Schlüssel erstellen und füllen Sie Name des Schlüssels aus
  5. Wählen Sie die Gruppen unter Erlaubte Endpunktgruppen
  6. Kopieren Sie den API-Schlüssel im Klartext und speichern Sie ihn sicher (er wird nur einmal angezeigt!)

Sie brauchen Zugriff auf die Projekteinstellungen. Jede Änderung auf dieser Seite fragt Ihren zweiten Faktor ab, sofern Sie ihn nicht in den letzten zehn Minuten bestätigt haben.

Partner-API-Einstellungen mit Endpunktgruppen und API-Schlüsseln
  1. Integrationen
  2. Endpunktgruppen
  3. API-Schlüssel erstellen
  4. Schlüssel rotieren oder widerrufen
📸 Partner-API-Einstellungen mit Endpunktgruppen und API-Schlüsseln

Code-Beispiele

npm install @tixfin/partner-api-client
import { TixfinPartnerClient } from "@tixfin/partner-api-client";

const client = new TixfinPartnerClient({
  projectId: process.env.TIXFIN_PROJECT_ID,
  apiKey: process.env.TIXFIN_PARTNER_API_KEY,
  baseUrl: "https://beta-rest-api.tixfin.com",
});

const events = await client.listEvents();
console.log(events.items);
pip install tixfin-partner-api
import os
from tixfin_partner_api import TixfinPartnerClient

client = TixfinPartnerClient(
    project_id=os.environ["TIXFIN_PROJECT_ID"],
    api_key=os.environ["TIXFIN_PARTNER_API_KEY"],
    base_url="https://beta-rest-api.tixfin.com",
)

events = client.list_events()
print(events.items)
curl "https://beta-rest-api.tixfin.com/api/partner/projects/$TIXFIN_PROJECT_ID/events" \
  -H "X-API-Key: $TIXFIN_PARTNER_API_KEY"

Die vollständige Client-Referenz finden Sie in der SDK-Anleitung. Sie können die REST-API aber auch mit jedem HTTP-Client direkt aufrufen.

Fehlerbehandlung

Häufige Authentifizierungsfehler

CodedetailLösung
401An API key is required.Den Header X-API-Key oder Authorization: Bearer mitsenden
401Invalid API key.Der Schlüssel ist fehlerhaft, widerrufen, rotiert, abgelaufen oder hat nie existiert. Die Antwort sagt nicht, was davon zutrifft
403This API key is not issued for that project.Die projectId aufrufen, für die der Schlüssel erstellt wurde
403This API key does not carry the … endpoint group.Einen Schlüssel mit dieser Gruppe erstellen oder verwenden
403The … endpoint group is disabled for this project.Die Gruppe unter Endpunktgruppen aktivieren
429Partner API rate limit exceeded. / API key rate limit exceeded.Die Sekunden aus Retry-After abwarten (Grenzen siehe unten)

Fehlerantwort

{
  "title": "Unauthorized",
  "status": 401,
  "detail": "Invalid API key.",
  "timestamp": "2026-10-25T09:30:00.000000000Z"
}

Sicherheitsempfehlungen

✅ So ist es richtig

Sicher speichern

# Umgebungsvariablen (empfohlen)
export TIXFIN_PARTNER_API_KEY="YOUR_API_KEY"

Eng zuschneiden

  • Nur die Endpunktgruppen (events.read, tickets.read usw.) vergeben, die ein Schlüssel wirklich braucht
  • Pro Integration einen eigenen Schlüssel erstellen, statt einen breit zu teilen

Regelmäßig rotieren

  • Schlüssel regelmäßig unter Konto → Integrationen rotieren. Beim Rotieren behält der Schlüssel Namen und Gruppen und erhält ein neues Präfix und Geheimnis; der alte Schlüssel funktioniert sofort nicht mehr
  • Schlüssel widerrufen, die Sie nicht mehr nutzen

Nur HTTPS

  • Schlüssel nie über HTTP senden
  • Immer https://beta-rest-api.tixfin.com verwenden

❌ So nicht

Nie in Git einchecken

// ❌ FALSCH
const apiKey = "YOUR_API_KEY";

// ✅ RICHTIG
const apiKey = process.env.TIXFIN_PARTNER_API_KEY;

Nie clientseitig verwenden

<!-- ❌ FALSCH – der API-Schlüssel ist für Nutzer sichtbar -->
<script>
  const apiKey = "YOUR_API_KEY";
</script>

Die Partner-API ist schreibgeschützt, aber ein geleakter Schlüssel legt trotzdem Ihre Event-, Ticket- und Bestelldaten offen – behandeln Sie ihn wie jedes andere Geheimnis.

Ratenbegrenzung

BereichDauerrateSpitze
Pro API-Schlüssel10 Anfragen/Sekunde (600/Minute)60
Pro IP-Adresse5 Anfragen/Sekunde (300/Minute)30

Wer eine davon überschreitet, erhält 429 mit einem Retry-After-Header in Sekunden.

Brauchen Sie Hilfe?

Authentifizierung schlägt fehl?

  1. Prüfen Sie, ob der Schlüssel stimmt (frisch einfügen, ohne Leerzeichen davor oder danach)
  2. Prüfen Sie, ob Sie die richtige projectId aufrufen
  3. Prüfen Sie, ob der Schlüssel widerrufen oder rotiert wurde
  4. Prüfen Sie, ob der Schlüssel die aufgerufene Endpunktgruppe trägt und ob die Gruppe für das Projekt aktiviert ist

Kommen Sie nicht weiter?

  • E-Mail: api@tixfin.com
  • Bitte angeben: nur das Präfix Ihres Schlüssels (nie den ganzen Schlüssel), den aufgerufenen Endpunkt, die Fehlermeldung

Nächste Schritte

Auf dieser Seite