Fehlercodes

Alle Firmium-API-Endpunkte erfordern Authentifizierung mit einem gültigen API-Key (Token). Die folgenden Fehlercodes können bei der Nutzung der API auftreten.

400 – Bad Request

Die Anfrage ist fehlerhaft oder unvollständig. Beispiel:
{
  "error": "Ungültige Anfrageparameter",
  "code": "bad_request"
}

401 – Unauthorized

Das Token fehlt, ist ungültig oder abgelaufen. Ohne gültige Authentifizierung ist kein Zugriff auf die API möglich. Beispiel:
{
  "error": "Ungültiges oder abgelaufenes Token",
  "code": "unauthorized"
}

403 – Forbidden

Du hast keine ausreichenden Berechtigungen für diese Aktion, obwohl du authentifiziert bist. Beispiel:
{
  "error": "Unzureichende Berechtigungen",
  "code": "forbidden"
}

404 – Not Found

Die angeforderte Ressource existiert nicht. Beispiel:
{
  "error": "Nicht gefunden",
  "code": "not_found"
}

409 – Conflict

Es besteht ein Konflikt, z.B. beim Erstellen einer Ressource, die bereits existiert. Beispiel:
{
  "error": "Konflikt: Ressource existiert bereits",
  "code": "conflict"
}

429 – Too Many Requests

Das Rate Limit wurde überschritten. Auch authentifizierte Nutzer können limitiert werden. Beispiel:
{
  "error": "Rate limit exceeded. Please try again later or log in for higher limits.",
  "limit": 100,
  "reset_in": 42,
  "reset_at": "12:34:56"
}

500 – Internal Server Error

Ein unerwarteter Fehler ist aufgetreten. Bitte versuche es später erneut. Beispiel:
{
  "error": "Interner Serverfehler",
  "code": "server_error"
}

Letzte Aktualisierung am 16.07.2025