Start using our API in 5 minutes.

LeaseWeb offers several different APIs, each using a unique API key to verify your API requests.

• LeaseWeb API: you can generate your API key at the Customer Portal
• LeaseWeb CDN API: you can generate your API key inside CDNs Control Panel

In order to access our API, you will need to issue your requests against these URLs:

• LeaseWeb API: https://api.leaseweb.com
• LeaseWeb CDN API: https://api.leasewebcdn.com

Each API request needs to be authenticated. At this moment each API provides a different method to authenticate your requests.

LeaseWeb API

To authenticate your call, add your API key to the request header `X-Lsw-Auth`.

LeaseWeb CDN API

To use this API you must use the secret key provided in LeaseWebs CDN Control Panel and authenticate at each call.

The algorithm used for authentication is the following:

1. Get the URI you want to access
2. Get the current timestamp (Must be in UTC timezone)
3. sha1(key + timestamp + URI)
4. Append timestamp to the URL
5. Append signature to the URL

In PHP, this would look like this:

<?php
$secret = 'mySecretKey';
$customer_number = '1234567890';
$zone_id = '100';
$path = '/zones/push/' . $customer_number . '/' . $zone_id;
$time = time();
$signature = sha1($secret.$time.$path);
$full_path = 'https://api.leasewebcdn.com'.$path.'/'.$time.'/'.$signature;

Now that you know how to authenticate an API call, it is time to make your first test call. In this example, you will retrieve a list of Bare Metal Servers you currently have at LeaseWeb.

To begin, your first request may look like this:

<?php
$resource = '/bareMetals/v2/servers';
$apiKey   = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';
$apiUrl   = 'https://api.leaseweb.com';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl . $resource);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("X-Lsw-Auth: $apiKey"));
$output = curl_exec($ch);

echo $output;