Zum Hauptteil navigieren

Los geht’s

API: Drive (classic)

In diesem Dokument wird die Drive (classic)-API behandelt. Wenn du die Drive-API verwendest, lies das Tutorial für die ersten Schritte mit den Drive-APIs.

Mit dieser API kannst du unsere On-Demand-Logistikplattform nutzen, sodass du Waren auch ohne eigene Lieferteams schnell und einfach ausliefern kannst.

Was ist Drive (classic)?​

Drive (classic) ist die Legacy-Version der Drive-API. Sie verfügt über weitere Funktionen, darunter:

  • Webhooks
  • Unternehmens- und Standortmodellierung
  • Unterstützung bei der Rechnungsstellung
  • Geplante Lieferungen

Die Drive (classic)-API ist ideal für große Unternehmen und Middleware-Anbieter, die ein Höchstmaß an Konfiguration und Anpassbarkeit benötigen.

Ein typischer Ablauf:​

  • Ein Angebot anfordern (optional). Dies informiert dich über die geschätzte Abholzeit und die Abholkosten für deine Lieferung.
  • Anforderung einer Bestellung.
  • Verschiebe die Lieferung, ändere sie oder storniere sie bis zu einem bestimmten Zeitpunkt vor der Abholung oder gib die Bestellung nach der Abholung an den Anbieter zurück.
  • Die Bestellung wird abgeschlossen.

Eine Bestellung wird in einem geplanten Status mit dem Ereignis „delivery_created“ erstellt. Der Endstatus ist entweder „geliefert“ oder „storniert“. Bei wichtigen Ereignissen ändert sich der Status der Bestellung und/oder der Status des:der Kurier:in.

So erstellst du eine Lieferung​

Bevor du loslegst, solltest du einen Zugriffsschlüssel erstellen und einen JWT generieren.

Alle Drive (classic)-API-Aufrufe findest du unter https://openapi.doordash.com/drive/v1/{resource}.

Zur Authentifizierung musst du das JWT als Bearer-Token im Authentifizierungs-Header der Anfrage angeben.

Weitere Informationen findest du in der API-Referenz .

Wichtige Hinweise:​

Bitte führe alle Vorgänge, bei denen einer der 50x-Antwortcodes ausgegeben wurde, erneut durch, da es sich um einen vorübergehenden Fehler handeln könnte. Wir empfehlen bis zu drei Wiederholungsversuche mit einem exponentiellen Backoff zwischen den einzelnen Versuchen.

Wenn du eine Zeit für eine der unten aufgeführten APIs angibst (z. B. pickup_time oder delivery_time), muss das Format UTC sein.