Fehlercodes & Statusreferenz

Umfassende Anleitung zu Smart Money API-Fehlercodes, HTTP-Statuscodes und Schritten zur Fehlerbehebung. Verstehen Sie Fehlerantworten und lösen Sie Integrationsprobleme schnell.

2xx Erfolgscodes

Erfolgsantworten zeigen an, dass die Anfrage erfolgreich verarbeitet wurde.

Code	Status	Bedeutung
200	OK	Anfrage erfolgreich. Der Antwortkörper enthält die angeforderten Daten.
201	Created	Ressource wurde erfolgreich erstellt. Die Antwort enthält die neue Ressource.
204	No Content	Anfrage erfolgreich, aber es gibt keine Inhalte zurückzugeben (z.B. DELETE).

Beispiel 200-Antwort

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [...],
    "pagination": {
      "page": 1,
      "limit": 50
    }
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

4xx Client-Fehlercodes

Client-Fehler zeigen an, dass die Anfrage fehlerhaft oder ungültig war. Korrigieren Sie Ihre Anfrage und versuchen Sie es erneut.

Code	Status	Ursache
400	Bad Request	Fehlerhafte Anfragetyntax. Überprüfen Sie Abfrageparameter, Header und Anfragekörper.
401	Unauthorized	Fehlende oder ungültige Authentifizierungsdaten. Überprüfen Sie Ihren API-Schlüssel oder JWT-Token.
402	Payment Required	Ihre Abonnementzahlung ist fehlgeschlagen. Aktualisieren Sie die Zahlungsinformationen in Ihrem Konto.
403	Forbidden	Authentifiziert, aber nicht für diese Ressource autorisiert. Ihr Plan beinhaltet diese Funktion nicht.
404	Not Found	Ressource existiert nicht. Überprüfen Sie die Endpunkt-URL und Parameter.
429	Too Many Requests	Ratenbegrenzung überschritten. Warten Sie, bevor Sie es erneut versuchen. Überprüfen Sie den Retry-After-Header.
422	Unprocessable Entity	Validierung fehlgeschlagen. Anfrageparameter sind ungültig oder erforderliche Felder fehlen.

Beispiele für Authentifizierungsfehler

Fehlender API-Schlüssel (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "Authentifizierungsdaten nicht bereitgestellt.",
    "resolution": "Fügen Sie Ihren API-Schlüssel im Authorization-Header ein: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Ungültiger API-Schlüssel (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "Ungültiger oder abgelaufener API-Schlüssel.",
    "resolution": "Generieren Sie einen neuen API-Schlüssel in Ihrer Konsole unter https://smartmoneyapi.com/console"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Ratenbegrenzung (429)

Wenn Sie Ihr API-Kontingent überschreiten, gibt der Server 429 Too Many Requests zurück. Überprüfen Sie die Antwort-Header für Ratenbegrenzungsinformationen:

HTTP-Header

X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600

Ratenbegrenzungs-Fehlerantwort

JSON

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Tägliches API-Anfragelimit (200) überschritten.",
    "resolution": "Upgrade auf den Trader- ($29/Monat, 400 Anfragen/Tag) oder Pro-Plan ($79/Monat, 4.000 Anfragen/Tag).",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Validierungsfehler (422)

Validierungsfehler treten auf, wenn Ihre Anfrageparameter ungültig sind oder erforderliche Felder fehlen.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Anfragevalidierung fehlgeschlagen.",
    "details": [
      {
        "field": "symbol",
        "error": "Ungültiges Trading-Paar. Erwartetes Format: BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "Muss eine positive Zahl sein"
      }
    ],
    "resolution": "Beheben Sie die Validierungsfehler und versuchen Sie es erneut."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

5xx Server-Fehlercodes

Server-Fehler zeigen ein Problem auf unserer Seite an. Diese sind vorübergehend und werden normalerweise schnell behoben. Implementieren Sie eine exponentielle Backoff-Wiederholungslogik.

Code	Status	Maßnahme
500	Internal Error	Unerwarteter Serverfehler. Wiederholen Sie den Vorgang mit exponentiellem Backoff.
502	Bad Gateway	Vorübergehende Dienstunterbrechung. Versuchen Sie es nach einigen Sekunden erneut.
503	Service Unavailable	Wartung oder vorübergehender Ausfall. Überprüfen Sie die Statusseite. Wiederholen Sie den Vorgang nach dem Retry-After-Intervall.
504	Gateway Timeout	Die Anfrage dauerte zu lange. Der Server hat sie möglicherweise trotzdem verarbeitet. Überprüfen Sie die Idempotenz.

Beispiel für Serverfehler (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "Dienst vorübergehend nicht verfügbar aufgrund von Wartungsarbeiten.",
    "resolution": "Bitte versuchen Sie es nach 5 Minuten erneut. Verfolgen Sie den Status unter https://status.smartmoneyapi.com"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Anleitung zur Fehlerbehebung

401 Unauthorized – Ungültiger API-Schlüssel

Problem: Erhalten 401-Fehler trotz API-Schlüssel.

Lösungen:

Überprüfen Sie, ob der API-Schlüssel im Authorization-Header mit "Bearer"-Präfix enthalten ist
Prüfen Sie, ob Ihr API-Schlüssel nicht abgelaufen oder widerrufen wurde
Stellen Sie sicher, dass Sie den richtigen Schlüssel verwenden (Produktion, Staging oder Entwicklung)
Generieren Sie einen neuen API-Schlüssel in Ihrer Konsole, falls der aktuelle verloren ging

403 Forbidden – Funktion nicht verfügbar

Problem: Erhalten 403-Fehler bei bestimmten Endpunkten.

Lösungen:

Überprüfen Sie Ihre API-Stufe. Einige Endpunkte erfordern Trader- oder Pro-Pläne
Upgraden Sie Ihren Plan unter /pricing.html, um Premium-Funktionen zu nutzen
Stellen Sie sicher, dass der API-Schlüssel die erforderlichen Berechtigungen hat
Kontaktieren Sie den Support, wenn Sie glauben, Zugriff haben zu sollten

429 Too Many Requests – Ratenbegrenzung

Problem: Erhalten 429-Fehler und Ratenbegrenzung.

Lösungen:

Implementieren Sie exponentielle Backoff-Wiederholungslogik (warten Sie 1s, 2s, 4s usw.)
Cachen Sie Antworten, um redundante API-Aufrufe zu vermeiden
Verwenden Sie WebSocket für Echtzeitdaten anstelle von REST-Endpunkt-Abfragen
Upgraden Sie Ihren Plan für höhere Kontingente (Trader 1,000/Tag, Pro 5.000/Tag)
Bündeln Sie mehrere Abfragen in einzelne Anfragen, wo möglich

400 Bad Request – Ungültige Parameter

Problem: Erhalten 400-Fehler bei fehlerhaften Anfragen.

Lösungen:

Überprüfen Sie die API-Dokumentation für erforderliche und optionale Parameter
Überprüfen Sie die Parametertypen (Strings vs. Zahlen, Arrays vs. Objekte)
Stellen Sie sicher, dass JSON gültig und korrekt formatiert ist
Verwenden Sie korrekte Endpunkt-URLs mit richtigen Pfadparametern
Überprüfen Sie die Schreibweise der Abfrageparameter

5xx Serverfehler - Vorübergehende Ausfälle

Problem: Erhalten Sie 500, 502, 503 oder 504 Fehler.

Lösungen:

Überprüfen Sie den Dienststatus unter https://status.smartmoneyapi.com
Implementieren Sie automatische Wiederholungsversuche mit exponentiellem Backoff (max. 5-10 Versuche)
Warten Sie 30-60 Sekunden, bevor Sie 503-Fehler erneut versuchen
Verwenden Sie den Retry-After-Header, um den Zeitpunkt für Wiederholungsversuche zu bestimmen
Abonnieren Sie die Statusseite für Incident-Benachrichtigungen

Fehlerantwortformat

Alle Fehlerantworten folgen einem einheitlichen Format:

JSON

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Menschenlesbare Fehlermeldung",
    "details": {...},
    "resolution": "Schritte zur Behebung des Problems"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Brauchen Sie weitere Hilfe?

Überprüfen Sie unsere API-Dokumentation oder kontaktieren Sie den Support mit Ihrem Fehlercode und den Anfragedetails.

API-Referenz

Support erhalten

Haben Sie Fragen? Überprüfen Sie unsere Dokumentation oder wenden Sie sich an den Support.

Konsole öffnen