Entwickler Dokumentation

Integrieren Sie die leistungsstarke Logistik-Engine von BestellDirekt in Ihre Applikation. Unsere RESTful API ermöglicht es Ihnen, Lieferungen in über 500 Städten weltweit zu steuern, zu verfolgen und zu optimieren.

Schnelle Integration

Mit unseren SDKs für Node.js, Python und Ruby sind Sie in weniger als 15 Minuten startklar.

Enterprise Sicherheit

Ende-zu-Ende Verschlüsselung und granulare Berechtigungen für Ihre API-Keys.

Authentifizierung

Jede Anfrage erfordert einen Bearer-Token im Authorization-Header. API-Keys können im Partner-Dashboard erstellt und mit Rollen versehen werden.

Authorization: Bearer bd_live_51Px...your_secure_api_token
Content-Type: application/json

Rate Limiting

Standard-Limits pro Account zur Sicherstellung der Systemintegrität:

10.000

Anfragen / Std.

200

Burst (Concurrent)

50

Websocket Slots

Pagination

Listen-Endpunkte verwenden ein cursor-basiertes Pagination-System. Verwenden Sie die Parameter limit und after.

Antwort-Struktur JSON

{
  "data": [...],
  "has_more": true,
  "next_cursor": "ord_9182kjs..."
}

Bestellung erstellen

POST /orders

{
  "pickup_address": "Schillerstr. 10, 80336 München",
  "delivery_address": "Marienplatz 1, 80331 München",
  "vehicle_type": "bike",
  "items": [{ "name": "Paket", "weight_kg": 2 }]
}

Bestellungen abrufen

GET /orders

Ruft eine Liste aller Bestellungen ab. Nutzen Sie Query-Parameter wie `status`, um Ergebnisse zu filtern.

Query Parameter

status Filtert nach "pending", "active", "completed"
limit Anzahl Ergebnisse (Standard: 20, Max: 100)

Echtzeit-Tracking

WSS /tracking

Verbinden Sie sich per WebSocket, um Live-Koordinaten des Fahrers zu erhalten. Die Verbindung erfordert Authentifizierung via Token im ersten Payload.

CONNECTED

// Browser / Client
const socket = new WebSocket('wss://api.bestelldirekt.de/v2/tracking');
socket.send(JSON.stringify({ "action": "subscribe", "order_id": "ord_123" }));

// Server Response (Live Update)
{
  "order_id": "ord_123",
  "lat": 48.137154,
  "lng": 11.576124,
  "speed_kmh": 18.5,
  "heading": 94
}

Idempotenz

Vermeiden Sie doppelte Buchungen bei Netzwerkfehlern. Senden Sie den Header Idempotency-Key mit einem eindeutigen String (z.B. UUID v4).

POST /v2/orders
Idempotency-Key: f47ac10b-58cc-4372-a567-0e02b2c3d479

Batch Processing

POST /batch

{
  "operations": [
    { "method": "POST", "path": "/orders", "body": {...} },
    { "method": "POST", "path": "/orders", "body": {...} }
  ]
}