Wie erhalte ich einen DHL-API-Schlüssel?

DHL begrenzt die Anzahl der Requests pro Tag durch sogenanntes „Rate Limiting“. Wenn zum Beispiel ikas mehrmals am Tag Informationen von DHL abruft, kann es sein, dass das festgelegte Limit für den verwendeten API-Schlüssel in Kombination mit der Anzahl der täglich verfolgten DHL-Pakete schnell erreicht wird. In diesem Fall können wir bis zum nächsten Tag keine Updates mehr bereitstellen.

Deshalb bitten wir Dich, falls du durchschnittlich mehr als 5.000 aktive DHL-Pakete pro Tag verwaltest, Dich direkt mit DHL in Verbindung zu setzen, um uns einen eigenen API-Schlüssel bereitzustellen, den wir ausschließlich für Deine Pakete verwenden.

Anleitung

  1. Registriere Dich auf https://developer.dhl.com/user/register und fülle Deine Kontoinformationen aus.
  2. Du erhältst eine E-Mail von DHL mit einem Link zum Zurücksetzen.
  3. Sobald Dein Profil erstellt ist, klicke auf den Reiter "Apps" > "Create App".
  4. Fülle das Formular "Create App" aus:

    • App-Name: ikas
    • APIs auswählen: Shipment Tracking - Unified
  5. Klicke auf "Add to app" und anschließend auf "Create App".
  6. Die App ist jetzt erstellt! Klicke auf die App "ikas".
  7. Kopiere den Consumer Key (nicht den Consumer Secret!) und übertrage ihn auf ikas – das wird der API-Schlüssel sein, mit dem Deine DHL-Pakete verfolgt werden.
  8. Klicke auf "Request upgrade".

    Die DHL-API erlaubt standardmäßig nur 250 Anfragen pro Tag. Allerdings reagiert das DHL-Team in der Regel schnell und positiv auf Upgrade-Anfragen.

  9. Fülle das Upgrade-Formular aus. Hier sind unsere Empfehlungen:
    • Are you already a DHL customer ⇒ Ja

    • What's your expected rate of usage ⇒ Verwende diese einfache Berechnung:

      • Nimm die durchschnittliche Anzahl Deiner DHL-Pakete pro Tag (inklusive Rücksendungen).
      • Multipliziere diesen Wert mit 5 (angenommen, es dauert 5 Tage, bis die Pakete ankommen).
      • Multipliziere das Ergebnis mit 12 (für 12 Abfragen pro Tag).
      • ➡️ Jetzt hast du die Anzahl der Anfragen pro Tag (Es ist nicht notwendig, die Anfragen pro Sekunde auszufüllen).
      • Beispiel: Bei 2.000 DHL-Bestellungen pro Tag müsste ich 120.000 Anfragen/Tag anfordern.
    • What's your purpose of usage? ⇒ Ich möchte meine eigenen Sendungen verfolgen.

    • Please specify if there are any other usage ⇒ Schreibe Folgendes:

      - ikas will use our API key to track our DHL shipments

      - Number of DHL shipments per month: XXX
    • From which DHL division(s) do you want to track shipments? ⇒ Wähle die Service-Codes aus, falls Du sie kennst, andernfalls wähle alle aus.

      DHL wird nun Deinen Upgrade-Antrag prüfen.
  10. Trage, nachdem die Update-Anfrage bestätigt wurde, Deinen DHL Consumer key in der ikas DHL-App in das Feld Tracking API Client Key ein.