Zum Inhalt springen
LOGICAR Entwickler Suchen

#Schnellstart

Auf dieser Seite

In fünf Schritten von null zum ersten Testauftrag, dessen Webhooks Sie mitlesen. Alles passiert in der Sandbox: kein Fahrer fährt los, nichts wird berechnet.

#1. Testzugang anlegen

Im Portal unter Einstellungen → API-Zugang einen Zugang anlegen: Name, Umgebung Sandbox, Art API-Schlüssel, Rechte orders:read und orders:write. Der Schlüssel beginnt mit lc_test_ und wird nur einmal angezeigt — gleich sicher ablegen, etwa in einer Umgebungsvariablen:

bash
export LOGICAR_KEY="lc_test_…"

Für den Anfang genügt der Schlüssel. Wie Ihr System später per OAuth 2.0 ein Token holt, steht unter Anmeldung.

#2. Zugang prüfen

bash
curl https://api.logicar.cloud/api/v1/extern/me \
  -H "Authorization: Bearer $LOGICAR_KEY"
json
{
  "environment": "sandbox",
  "account": { "id": "…", "name": "Ihre Firma GmbH" },
  "credential": {
    "id": "…",
    "name": "Warenwirtschaft Test",
    "clientId": "lcc_…",
    "prefix": "lc_test_3f9a",
    "environment": "sandbox",
    "type": "api_key",
    "scopes": ["orders:read", "orders:write"],
    "expiresAt": null,
    "createdAt": "…"
  },
  "authentication": { "method": "api_key", "expiresAt": null },
  "apiVersion": "2026-09-01"
}

environment: "sandbox" bestätigt: alles Weitere landet im Testspeicher. scopes zeigt, was dieser Zugang darf.

#3. Test-Empfänger einrichten

Im Portal unter Einstellungen → Sandbox auf Test-Empfänger einrichten klicken. Die Plattform legt einen Webhook-Endpunkt an, der alle Ereignisse abonniert, und zeigt jeden Eingang mit Köpfen, Inhalt und dem Ergebnis der Signaturprüfung. Einen eigenen Server brauchen Sie dafür nicht (mehr zum Test-Empfänger).

#4. Testauftrag einstellen

bash
curl -X POST https://api.logicar.cloud/api/v1/extern/orders \
  -H "Authorization: Bearer $LOGICAR_KEY" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -d '{
    "externalOrderId": "TEST-0001",
    "vehicle": { "vin": "WVWZZZ1KZAW000001", "manufacturer": "Volkswagen", "model": "Golf" },
    "pickup": { "street": "Musterstraße 12", "postalCode": "20095", "city": "Hamburg" },
    "delivery": { "street": "Beispielweg 5", "postalCode": "80331", "city": "München" },
    "transportType": "DRIVEN",
    "requestedDelivery": "2026-10-02T16:00:00+02:00"
  }'

Die Antwort (201 Created) ist der Auftrag, wie ihn auch GET /orders/{id} liefert — gekürzt:

json
{
  "kind": "ORDER",
  "id": "…",
  "orderNumber": "SBX-2026-00001",
  "externalOrderId": "TEST-0001",
  "status": "ACCEPTED",
  "transportType": "DRIVEN",
  "price": { "net": 482.5, "gross": 574.18, "vatRate": 19, "currency": "EUR" },
  "sandbox": true,
  "…": "…"
}

Schicken Sie denselben Aufruf noch einmal: die Antwort ist dieselbe, mit dem Kopf Idempotent-Replayed: true — es entsteht kein zweiter Auftrag (Wiederholungen).

#5. Zusehen

Der Vorgang durchläuft jetzt selbstständig das Szenario Standard: freigegeben, Fahrer zugewiesen, abgeholt, zugestellt, abgeschlossen. Jeder Schritt schickt dieselben Webhooks, die der Echtbetrieb schicken würde. Sie sehen sie im Portal beim Test-Empfänger — oder fragen den Stand ab:

bash
curl https://api.logicar.cloud/api/v1/extern/orders/SBX-2026-00001/status \
  -H "Authorization: Bearer $LOGICAR_KEY"

Der Pfad nimmt unsere Kennung (id) oder die Auftragsnummer. Über Ihre eigene Nummer finden Sie den Auftrag mit GET /orders?externalOrderId=TEST-0001. Wer nicht warten will, schaltet von Hand weiter (Szenarien).

#Wie es weitergeht