Bolt.new AI and DHL API integration: Step-by-Step Guide 2025

 

Step 1: Configuring DHL API Credentials

 

• Create a new file in your project called dhlConfig.ts to store your DHL API configuration.
• Insert the following code snippet into dhlConfig.ts. Replace YOURDHLAPI_KEY with your actual DHL API key and adjust the base URL if necessary.

export const DHLConfig = {
  apiKey: 'YOURDHLAPI_KEY',
  baseUrl: 'https://api.dhl.com'
};

 

Step 2: Creating the DHL Service Integration Code

 

• Create a new file called dhlService.ts in your project. This file will contain functions to interact with the DHL API.
• Copy and paste the following TypeScript code into dhlService.ts. This sample function demonstrates how to call the DHL tracking API using fetch, which is available in the Bolt.new environment without extra installations.

import { DHLConfig } from './dhlConfig';

export async function getTrackingStatus(trackingNumber: string): Promise<any> {
  const url = ${DHLConfig.baseUrl}/track/shipments?trackingNumber=${trackingNumber};
  const response = await fetch(url, {
    method: 'GET',
    headers: {
      'DHL-API-Key': DHLConfig.apiKey,
      'Content-Type': 'application/json'
    }
  });
  const data = await response.json();
  return data;
}

 

Step 3: Using the DHL Service in Your Application

 

• Open your main TypeScript file where you want to integrate DHL API functionality. This could be your main entry point, for example main.ts.
• Import the service function from dhlService.ts, and add a sample function to call the DHL API using a test tracking number.
• Below is a code snippet to include in your main.ts file. Adjust the trackingNumber value as needed.

import { getTrackingStatus } from './dhlService';

async function testDHLIntegration() {
  const trackingNumber = 'YOURTRACKINGNUMBER'; // Replace with an actual tracking number
  try {
    const trackingData = await getTrackingStatus(trackingNumber);
    console.log('Tracking Data:', trackingData);
  } catch (error) {
    console.error('Error fetching DHL tracking status:', error);
  }
}

testDHLIntegration();

 

Step 4: Managing Dependencies in Bolt.new

 

• Bolt.new projects do not allow terminal access for dependency installation. Fortunately, the above code relies on the built-in fetch API available in the environment.
• Ensure that your project configuration file (if available) securely stores your DHL API credentials. If Bolt.new provides an environment variables configuration utility, use it to keep your API key secure instead of hardcoding it.