🇪🇸 Español 🇬🇧 English 🇦🇪 العربية 🇫🇷 Français 🇩🇪 Deutsch
Dashboard

Fehlercodes

Vollständige Referenz aller API-Fehlercodes.

Fehlerantwortformat

Wenn ein Fehler auftritt, gibt die API eine Antwort im folgenden Format zurück:

JSON 
{
    "success": false,
    "error": {
        "code": "ERROR_CODE",
        "message": "Lesbare Fehlerbeschreibung",
        "details": {
            // Zusätzliche Informationen (optional)
        }
    }
}

Felder

Feld Typ Beschreibung
code string Eindeutiger Fehlercode (zur Programmierung von Logik)
message string Beschreibende Nachricht (kann dem Benutzer angezeigt werden)
details object Zusätzliche Details (ungültige Felder usw.)

Authentifizierungsfehler (401, 403)

Code HTTP Beschreibung
MISSING_API_KEY 401 X-API-Key-Header wurde nicht eingeschlossen
INVALID_API_KEY 401 API-Schlüssel ungültig oder nicht gefunden
API_KEY_DISABLED 403 Der API-Schlüssel wurde deaktiviert
API_KEY_EXPIRED 403 Der API-Schlüssel ist abgelaufen
ORIGIN_NOT_ALLOWED 403 Die Ursprungsdomäne ist nicht autorisiert
TENANT_INACTIVE 403 Das Geschäftskonto ist nicht aktiv
MISSING_TOKEN 401 JWT-Token erforderlich, aber nicht bereitgestellt
INVALID_TOKEN 401 Ungültiger oder fehlerhafter JWT-Token
TOKEN_EXPIRED 401 JWT-Token abgelaufen
INVALID_CREDENTIALS 401 E-Mail oder Passwort falsch (Anmeldung)

Rate-Limiting-Fehler (429)

Code HTTP Beschreibung
RATE_LIMIT_EXCEEDED 429 Zu viele Anfragen, warten Sie vor dem erneuten Versuch
LOGIN_ATTEMPTS_EXCEEDED 429 Zu viele fehlgeschlagene Anmeldeversuche
REGISTRATION_LIMIT_EXCEEDED 429 Zu viele Registrierungsversuche

Wenn Sie einen 429-Fehler erhalten, überprüfen Sie die Antwort-Header:

Headers 
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1704067260
Retry-After: 45

Validierungsfehler (400)

Code HTTP Beschreibung
VALIDATION_ERROR 400 Ein oder mehrere Felder haben ungültige Werte
MISSING_REQUIRED_FIELD 400 Ein Pflichtfeld fehlt
INVALID_EMAIL 400 Ungültiges E-Mail-Format
INVALID_PHONE 400 Ungültiges Telefonformat
INVALID_DATE 400 Ungültiges Datumsformat (muss JJJJ-MM-TT sein)
INVALID_TIME 400 Ungültiges Zeitformat (muss HH:MM sein)
DATE_IN_PAST 400 Das Datum liegt vor heute
DATE_TOO_FAR 400 Das Datum überschreitet das Vorausbuchungslimit

Beispiel mit Details

JSON 
{
    "success": false,
    "error": {
        "code": "VALIDATION_ERROR",
        "message": "Die gesendeten Daten sind ungültig",
        "details": {
            "email": ["Ungültiges E-Mail-Format"],
            "telefono": ["Dieses Feld ist erforderlich"],
            "fecha": ["Das Datum darf nicht vor heute liegen"]
        }
    }
}

Ressourcenfehler (404)

Code HTTP Beschreibung
SERVICE_NOT_FOUND 404 Service nicht gefunden
PROFESSIONAL_NOT_FOUND 404 Fachmann nicht gefunden
BOOKING_NOT_FOUND 404 Buchung nicht gefunden
CLIENT_NOT_FOUND 404 Kunde nicht gefunden
CATEGORY_NOT_FOUND 404 Kategorie nicht gefunden

Buchungsfehler

Code HTTP Beschreibung
SLOT_UNAVAILABLE 400 Die Zeit ist nicht mehr verfügbar
PROFESSIONAL_NOT_WORKING 400 Der Fachmann arbeitet zu diesem Tag/dieser Uhrzeit nicht
SERVICE_NOT_OFFERED 400 Der Fachmann bietet diesen Service nicht an
BUSINESS_CLOSED 400 Das Geschäft ist an diesem Datum geschlossen
CANNOT_CANCEL 400 Die Buchung kann nicht storniert werden (bereits vergangen oder bereits storniert)
CANCELLATION_DEADLINE_PASSED 400 Die Stornierungsfrist ist abgelaufen
BOOKING_ALREADY_PAID 400 Die Buchung wurde bereits bezahlt

Zahlungsfehler

Code HTTP Beschreibung
STRIPE_NOT_CONFIGURED 400 Das Geschäft hat Stripe nicht konfiguriert
INVALID_AMOUNT 400 Ungültiger Betrag (muss positiv sein)
PAYMENT_FAILED 400 Fehler bei der Zahlungsabwicklung
CARD_DECLINED 400 Karte abgelehnt
INSUFFICIENT_FUNDS 400 Unzureichende Mittel

Punktefehler

Code HTTP Beschreibung
INSUFFICIENT_POINTS 400 Sie haben nicht genügend Punkte
POINTS_NOT_ENABLED 400 Das Punkteprogramm ist nicht aktiv
SERVICE_NOT_REDEEMABLE 400 Dieser Service ist nicht gegen Punkte einlösbar

Serverfehler (500)

Code HTTP Beschreibung
INTERNAL_ERROR 500 Interner Serverfehler
SERVICE_UNAVAILABLE 503 Service vorübergehend nicht verfügbar
500-Fehler

Wenn Sie wiederholt 500-Fehler erhalten, kontaktieren Sie den Support unter developers@salonbookit.com