Fehler & Rate Limits

HTTP-Statuscodes

Code	Bedeutung	Typische Ursache
200	OK	Anfrage erfolgreich
201	Created	Ressource erstellt
400	Bad Request	Ungültiger Request-Body oder Parameter
401	Unauthorized	Token fehlt oder abgelaufen
402	Payment Required	Modul nicht lizenziert
403	Forbidden	Keine Berechtigung für diese Aktion
404	Not Found	Ressource nicht gefunden
422	Unprocessable Entity	Validierungsfehler
429	Too Many Requests	Rate-Limit erreicht
500	Internal Server Error	Server-Fehler

Error-Response-Format

{
  "error": true,
  "code": 422,
  "message": "Validation failed",
  "errors": [
    { "field": "email", "message": "E-Mail ist ungültig" }
  ]
}

Rate Limits

Methode	Limit	Fenster
Per IP (ohne Token)	1.500 Requests	1 Stunde
Per API-Token	3.600 Requests	1 Stunde

Bei Überschreitung: 429 Too Many Requests. Der Retry-After Header gibt die Wartezeit in Sekunden an.

Pagination

GET /consumers?limit=20&skip=40

// Response
{
  "payload": [...],
  "meta": {
    "total": 1250,
    "limit": 20,
    "skip": 40,
    "page": 3
  }
}

Maximales limit: 1000. Default: 20.

Response-Format

Alle API-Antworten folgen dem Schema:

{
  "payload": [...],          // Daten (Array oder Objekt)
  "meta": {                  // Pagination + Audit
    "total": 1250,
    "limit": 20,
    "skip": 0
  }
}

Wichtig: Lesen Sie immer response.payload, nicht response.data.