Zum Inhalt springen
LOGICAR Entwickler Suchen

#Fehlersuche

Auf dieser Seite

#401, obwohl der Zugang stimmt

  • INVALID_CREDENTIALS: Leerzeichen oder Zeilenumbruch am Ende des Schlüssels? Beim Kopieren aus einer Datei passiert das leicht. Wurde der Zugang im Portal widerrufen? Die Liste unter Einstellungen → API-Zugang zeigt die aktiven.
  • TOKEN_EXPIRED: das Token ist älter als eine Stunde — ein neues holen.
  • ACCESS_TOKEN_REQUIRED: das Secret eines OAuth-Clients wurde direkt mitgeschickt. Erst ein Token holen (Anmeldung).
  • Authorization: Bearer mit genau einem Leerzeichen, oder X-API-Key ohne Bearer.
  • GET /extern/me ist der einfachste Test: er zeigt Zugang, Umgebung und Rechte.

#403

  • FEATURE_NOT_ENABLED: der Echtbetrieb der Schnittstelle ist für Ihr Konto noch nicht freigeschaltet — die Sandbox schon. Sprechen Sie Ihren Ansprechpartner an.
  • INSUFFICIENT_SCOPE: dem Zugang fehlt das Recht; details.required nennt es. Im Portal ergänzen — und bei OAuth ein neues Token holen, wenn Ihr System es mit scope beschränkt hatte.

#Der Auftrag ist nicht im Portal

Mit welchem Schlüssel wurde er eingestellt? Ein lc_test_-Schlüssel legt Testvorgänge in der Sandbox an — sie stehen unter Einstellungen → Sandbox, nicht bei den Aufträgen. Der Kopf X-LogiCar-Environment jeder Antwort sagt, wo Sie gelandet sind.

#400 INVALID_REQUEST

details.fields nennt jedes Feld mit Code und Grund. Häufig:

  • unrecognized_key: ein Feld, das es nicht gibt — ein Tippfehler wie pickup.zip statt pickup.postalCode, oder ein Preisfeld. Freie Daten gehören in metadata.
  • Ein Zeitpunkt ohne Zeitzone oder im deutschen Format: 2026-10-01T08:00:00Z oder 2026-10-01T10:00:00+02:00, nicht 01.10.2026 und nicht 2026-10-01T08:00:00.
  • Ein Auswahlwert, den es nicht gibt, etwa TRUCK als vehicle.type statt TRUCK_7_5.
  • Eine Zahl, wo Text erwartet wird, etwa eine Postleitzahl ohne Anführungszeichen.

#422

Der Auftrag ist verständlich, aber so nicht ausführbar — details.errors nennt den Grund, etwa VEHICLE_NOT_DRIVEABLE für ein nicht fahrbereites Fahrzeug mit DRIVEN (Fehlercodes).

#Webhooks kommen nicht an

  1. Umgebung: Testvorgänge gehen nur an Sandbox-Endpunkte, echte nur an Endpunkte des Echtbetriebs.
  2. Abonnement: Ist das Ereignis beim Endpunkt angehakt?
  3. Protokoll: Unter Einstellungen → Webhooks zeigt jeder Endpunkt seine Zustellungen mit HTTP-Status und Fehler.
  4. Erreichbarkeit: Die Adresse muss aus dem Internet per HTTPS erreichbar sein. Interne Adressen werden abgewiesen, Weiterleitungen nicht verfolgt.
  5. Pausiert? Ein pausierter Endpunkt bekommt nichts.
  6. Testnachricht senden — kommt sie an, liegt es am Abonnement oder an der Umgebung.

#Die Signatur stimmt nicht

Fast immer liegt es am Rumpf: Ihr Framework hat ihn als JSON gelesen und neu geschrieben, bevor Sie rechnen. Lesen Sie ihn roh (Beispiele unter Signatur prüfen). Weitere Ursachen:

  • Falsches Geheimnis — nach Geheimnis erneuern gilt nur noch das neue.
  • Punkt vergessen: gerechnet wird über <Timestamp>.<Rumpf>.
  • Vergleich mit dem Hexwert ohne sha256= davor.
  • Uhr Ihres Servers geht falsch: mehr als fünf Minuten Abweichung, und jede Nachricht fällt durch die Zeitprüfung.

Rechnen Sie mit dem Beispiel unter Zum Nachrechnen nach — stimmt es dort, stimmt Ihr Verfahren.

#429 RATE_LIMITED

Warten Sie die Sekunden aus Retry-After ab. Tritt es regelmäßig auf, schickt Ihr System Aufrufe gebündelt — verteilen Sie sie, und fragen Sie den Stand nicht in kurzen Abständen ab, sondern nutzen Sie Webhooks.

#Nichts hilft

Schreiben Sie uns mit der requestId der Antwort, bzw. der X-LogiCar-Delivery des Webhooks, und dem Zeitpunkt (Kontakt).