Erste Schritte (API)

API: Drive

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

Mit der Drive-API kannst du unsere On-Demand-Logistikplattform nutzen, sodass du Waren auch ohne eigene Lieferteams schnell und einfach ausliefern kannst. Die Drive-API wurde entwickelt, um die Durchführung deiner Lieferungen so einfach wie möglich zu gestalten.

Ein typischer Ablauf:

• Ein Angebot anfordern (optional). Dies informiert dich über die geschätzte Abholzeit und die Abholkosten für deine Lieferung.
• Eine Lieferung anfordern oder ein Angebot annehmen.
• Die Bestellung wird abgeschlossen.

So erstellst du eine Lieferung

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

JavaScript

const axios = require('axios')
const { v4: uuidv4 } = require('uuid')

const body = JSON.stringify({
  external_delivery_id: uuidv4(), // keep track of the generated id here or in the response
  pickup_address: '901 Market Street 6th Floor San Francisco, CA 94103',
  pickup_business_name: 'Wells Fargo SF Downtown',
  pickup_phone_number: '+16505555555',
  pickup_instructions: 'Enter gate code 1234 on the callbox.',
  dropoff_address: '901 Market Street 6th Floor San Francisco, CA 94103',
  dropoff_business_name: 'Wells Fargo SF Downtown',
  dropoff_phone_number: '+16505555555',
  dropoff_instructions: 'Enter gate code 1234 on the callbox.',
  order_value: 1999,
})

axios
  .post('https://openapi.doordash.com/drive/v2/deliveries', body, {
    headers: {
      Authorization: 'Bearer ' + token,
      'Content-Type': 'application/json',
    },
  })
  .then(function (response) {
    console.log(response.data)
  })
  .catch(function (error) {
    console.log(error)
  })

Python

import requests
import uuid

endpoint = "https://openapi.doordash.com/drive/v2/deliveries/" # DRIVE API V2

headers = {"Authorization": "Bearer " + token,
            "Content-Type": "application/json"}

delivery_id = str(uuid.uuid4()) # Randomly generated UUID4

request_body = { # Modify pickup and drop off addresses below
    "external_delivery_id": delivery_id,
    "pickup_address": "901 Market Street 6th Floor San Francisco, CA 94103",
    "pickup_business_name": "Wells Fargo SF Downtown",
    "pickup_phone_number": "+16505555555",
    "pickup_instructions": "Enter gate code 1234 on the callbox.",
    "dropoff_address": "901 Market Street 6th Floor San Francisco, CA 94103",
    "dropoff_business_name": "Wells Fargo SF Downtown",
    "dropoff_phone_number": "+16505555555",
    "dropoff_instructions": "Enter gate code 1234 on the callbox.",
    "order_value": 1999
}

create_delivery = requests.post(endpoint, headers=headers, json=request_body) # Create POST request


print(create_delivery.status_code)
print(create_delivery.text)
print(create_delivery.reason)

PHP

$jwt = "Refer to How To > Get Started With JWTs"

// Modify pickup and drop off addresses below
$request_body = json_encode([
  "external_delivery_id" => "{Generate_your_own_id}",
  "pickup_address"=> "901 Market Street 6th Floor San Francisco, CA 94103",
  "pickup_business_name"=> "Wells Fargo SF Downtown",
  "pickup_phone_number"=> "+16505555555",
  "pickup_instructions"=> "Enter gate code 1234 on the callbox.",
  "dropoff_address"=> "901 Market Street 6th Floor San Francisco, CA 94103",
  "dropoff_business_name"=> "Wells Fargo SF Downtown",
  "dropoff_phone_number"=> "+16505555555",
  "dropoff_instructions"=> "Enter gate code 1234 on the callbox.",
  "order_value"=> 1999
]);

$headers = array(
  "Content-type: application/json",
  "Authorization: Bearer ".$jwt
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://openapi.doordash.com/drive/v2/deliveries/");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $request_body);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
echo($result)

Kotlin

import java.net.URI
import java.net.http.HttpClient
import java.net.http.HttpRequest
import java.net.http.HttpResponse
import java.util.*

val body = """{
    "external_delivery_id": "${UUID.randomUUID()}",
    "pickup_address": "901 Market Street 6th Floor San Francisco, CA 94103",
    "pickup_business_name": "Wells Fargo SF Downtown",
    "pickup_phone_number": "+16505555555",
    "pickup_instructions": "Enter gate code 1234 on the callbox.",
    "dropoff_address": "901 Market Street 6th Floor San Francisco, CA 94103",
    "dropoff_business_name": "Wells Fargo SF Downtown",
    "dropoff_phone_number": "+16505555555",
    "dropoff_instructions": "Enter gate code 1234 on the callbox.",
    "order_value": 1999
}"""

val client = HttpClient.newBuilder().build();
val request = HttpRequest.newBuilder()
    .uri(URI.create("https://openapi.doordash.com/drive/v2/deliveries/"))
    .header("Authorization", "Bearer $jwt")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

val response = client.send(request, HttpResponse.BodyHandlers.ofString());
println(response.body())

C#

using System.Text;
using System.Text.Json;

var jsonContent = JsonSerializer.Serialize(new {
    external_delivery_id = Guid.NewGuid().ToString(),
    pickup_address = "901 Market Street 6th Floor San Francisco, CA 94103",
    pickup_business_name = "Wells Fargo SF Downtown",
    pickup_phone_number = "+16505555555",
    pickup_instructions = "Enter gate code 1234 on the callbox.",
    pickup_reference_tag = "Order number 61",
    dropoff_address = "901 Market Street 6th Floor San Francisco, CA 94103",
    dropoff_business_name = "Wells Fargo SF Downtown",
    dropoff_phone_number = "+16505555555",
    dropoff_instructions = "Enter gate code 1234 on the callbox."
});
var content = new StringContent(jsonContent, Encoding.UTF8, "application/json");

HttpClient client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", token);
var result = await client.PostAsync("https://openapi.doordash.com/drive/v2/deliveries", content);

var status = result.StatusCode;
var resultString = await result.Content.ReadAsStringAsync();

So ermittelst du den Status einer Lieferung

JavaScript

const axios = require('axios')

axios
  .get(
    'https://openapi.doordash.com/drive/v2/deliveries/{external_delivery_id}',
    {
      headers: {
        Authorization: 'Bearer ' + token,
        'Content-Type': 'application/json',
      },
    },
  )
  .then(function (response) {
    console.log(response.data)
  })
  .catch(function (error) {
    console.log(error)
  })

Python

import requests
import uuid

endpoint = "https://openapi.doordash.com/drive/v2/deliveries/" # DRIVE API V2

headers = {"Authorization": "Bearer " + token,
            "Content-Type": "application/json"}

get_delivery = requests.get(endpoint + '{external_delivery_id}', headers=headers) # Create GET request

print(get_delivery.status_code)
print(get_delivery.text)
print(get_delivery.url)

PHP

$jwt = "Refer to How To > Get Started With JWTs"

$headers = array(
  "Content-type: application/json",
  "Authorization: Bearer ".$jwt
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://openapi.doordash.com/drive/v2/deliveries/{external_id_used_in_creation}");
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
echo($result)

Kotlin

import java.net.URI
import java.net.http.HttpClient
import java.net.http.HttpRequest
import java.net.http.HttpResponse
import java.util.*

val client = HttpClient.newBuilder().build();
val request = HttpRequest.newBuilder()
    .uri(URI.create("https://openapi.doordash.com/drive/v2/deliveries/{external_delivery_id}"))
    .header("Authorization", "Bearer $jwt")
    .build();

val response = client.send(request, HttpResponse.BodyHandlers.ofString());
println(response.body())

C#

HttpClient client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", token);
var result = await client.GetAsync($"https://openapi.doordash.com/drive/v2/deliveries/{external_delivery_id}", content);

var status = result.StatusCode;
var resultString = await result.Content.ReadAsStringAsync();

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.