How to Integrate Replit with DHL API

1import os
2import requests
3from typing import Optional
4
5DHL_API_KEY = os.environ["DHL_API_KEY"]
6BASE_URL = "https://api-eu.dhl.com"
7
8HEADERS = {
9    "DHL-API-Key": DHL_API_KEY,
10    "Accept": "application/json"
11}
12
13def track_shipment(tracking_number: str) -> dict:
14    """
15    Track a DHL shipment by waybill/tracking number.
16    Returns the full tracking response including events and status.
17    """
18    params = {"trackingNumber": tracking_number}
19    response = requests.get(
20        f"{BASE_URL}/track/shipments",
21        headers=HEADERS,
22        params=params
23    )
24    response.raise_for_status()
25    return response.json()
26
27def track_multiple(tracking_numbers: list) -> dict:
28    """
29    Track multiple shipments in one request (up to 10 numbers).
30    Pass a list of tracking number strings.
31    """
32    numbers_str = ",".join(tracking_numbers[:10])  # API limit: 10 per request
33    params = {"trackingNumber": numbers_str}
34    response = requests.get(
35        f"{BASE_URL}/track/shipments",
36        headers=HEADERS,
37        params=params
38    )
39    response.raise_for_status()
40    return response.json()
41
42def get_latest_status(tracking_number: str) -> Optional[dict]:
43    """
44    Get the latest tracking event and overall status for a shipment.
45    Returns None if the tracking number is not found.
46    """
47    try:
48        data = track_shipment(tracking_number)
49        shipments = data.get("shipments", [])
50        if not shipments:
51            return None
52        shipment = shipments[0]
53        events = shipment.get("events", [])
54        latest_event = events[0] if events else {}
55        return {
56            "tracking_number": tracking_number,
57            "status": shipment.get("status", {}).get("status"),
58            "description": shipment.get("status", {}).get("description"),
59            "estimated_delivery": shipment.get("estimatedTimeOfDelivery"),
60            "latest_location": latest_event.get("location", {}).get("address", {}).get("addressLocality"),
61            "latest_timestamp": latest_event.get("timestamp"),
62            "latest_description": latest_event.get("description"),
63            "event_count": len(events)
64        }
65    except requests.exceptions.HTTPError as e:
66        if e.response.status_code == 404:
67            return None
68        raise
69
70if __name__ == "__main__":
71    # Replace with a real DHL tracking number for testing
72    test_tracking = "1234567890"
73    result = get_latest_status(test_tracking)
74    if result:
75        print(f"Tracking {test_tracking}:")
76        print(f"  Status: {result['status']} — {result['description']}")
77        print(f"  Latest location: {result['latest_location']}")
78        print(f"  Estimated delivery: {result['estimated_delivery']}")
79    else:
80        print(f"Tracking number {test_tracking} not found")

1const express = require('express');
2const axios = require('axios');
3
4const app = express();
5app.use(express.json());
6
7const DHL_API_KEY = process.env.DHL_API_KEY;
8const DHL_EXPRESS_USER = process.env.DHL_EXPRESS_USER;
9const DHL_EXPRESS_PASSWORD = process.env.DHL_EXPRESS_PASSWORD;
10const DHL_ACCOUNT_NUMBER = process.env.DHL_ACCOUNT_NUMBER;
11
12const trackingClient = axios.create({
13  baseURL: 'https://api-eu.dhl.com',
14  headers: {
15    'DHL-API-Key': DHL_API_KEY,
16    Accept: 'application/json'
17  }
18});
19
20const expressClient = axios.create({
21  baseURL: 'https://express.api.dhl.com/mydhlapi',
22  auth: {
23    username: DHL_EXPRESS_USER,
24    password: DHL_EXPRESS_PASSWORD
25  },
26  headers: { Accept: 'application/json' }
27});
28
29// GET /track/:waybill — track a DHL shipment
30app.get('/track/:waybill', async (req, res) => {
31  try {
32    const response = await trackingClient.get('/track/shipments', {
33      params: { trackingNumber: req.params.waybill }
34    });
35    const shipments = response.data.shipments || [];
36    if (!shipments.length) {
37      return res.status(404).json({ error: 'Shipment not found' });
38    }
39    const shipment = shipments[0];
40    res.json({
41      trackingNumber: req.params.waybill,
42      status: shipment.status?.status,
43      description: shipment.status?.description,
44      estimatedDelivery: shipment.estimatedTimeOfDelivery,
45      events: (shipment.events || []).map(e => ({
46        timestamp: e.timestamp,
47        location: e.location?.address?.addressLocality,
48        description: e.description
49      }))
50    });
51  } catch (err) {
52    const status = err.response?.status || 500;
53    res.status(status).json({ error: err.response?.data?.detail || err.message });
54  }
55});
56
57// POST /rates — get DHL Express shipping rates
58// Body: { fromCountry, toCountry, weight, length, width, height, plannedShipDate }
59app.post('/rates', async (req, res) => {
60  const { fromCountry, toCountry, weight, length, width, height, plannedShipDate } = req.body;
61  try {
62    const response = await expressClient.get('/rates', {
63      params: {
64        accountNumber: DHL_ACCOUNT_NUMBER,
65        originCountryCode: fromCountry,
66        destinationCountryCode: toCountry,
67        weight,
68        length,
69        width,
70        height,
71        plannedShippingDateAndTime: plannedShipDate || new Date().toISOString()
72      }
73    });
74    res.json(response.data);
75  } catch (err) {
76    res.status(err.response?.status || 500).json({ error: err.message });
77  }
78});
79
80app.listen(3000, '0.0.0.0', () => {
81  console.log('DHL API proxy server running on port 3000');
82});