CoreNexis Image CDN API

The CoreNexis Image CDN API allows you to seamlessly upload and manage and share images through our content delivery network. We provides different storage durations and plan options to fit your needs.

Features

• Simple image uploads using direct file or URL
• Multiple storage duration options (7 days, 1 month, 3 months, lifetime)
• Fast, reliable content delivery through our global CDN
• Secure storage with automatic expiration
• Image viewer page with social sharing (free plan)
• Direct CDN URLs (paid plans)

Base URL

Authentication

All API requests require authentication using a client ID and client token. These credentials are plan-specific and determine your access level, storage options, and usage limits.

Test API Credentials

For testing purposes, you can use the following API credentials:

Rate Limits

API usage is subject to rate limits based on your plan. When you exceed your daily limit, requests will be rejected with a 429 status code.

Plan Limits

Endpoints

{
  "status": "success",
  "url": "https://cdn.corenexis.com/view/?img=d/ap5/AbCdEf.png", // Free plan (viewer URL)
  // OR
  "url": "https://cdn.corenexis.com/p/d/ap5/AbCdEf.png", // Paid plan (direct CDN URL)
  "expires_at": "2025-05-12" // OR "Never (Lifetime)" for LTF duration
}

Client Libraries

You can integrate with our API using various programming languages. Below are examples of how to use the API with common tools and languages.

curl -X POST \
  -F "client_id=client_3m_plan" \
  -F "client_token=8b5d24c7e3af9d87156a40b1c3e92f67" \
  -F "store_duration=7D" \
  -F "image=@/path/to/your/image.jpg" \
  https://cdn.corenexis.com/image/v2/

// Example using HTML form with JavaScript fetch
document.getElementById('uploadForm').addEventListener('submit', async (e) => {
  e.preventDefault();
  
  const formData = new FormData();
  formData.append('client_id', 'client_3m_plan');
  formData.append('client_token', '8b5d24c7e3af9d87156a40b1c3e92f67');
  formData.append('store_duration', '7D');
  
  // Get file from an input element
  const fileInput = document.getElementById('imageFile');
  formData.append('image', fileInput.files[0]);
  
  try {
    const response = await fetch('https://cdn.corenexis.com/image/v2/', {
      method: 'POST',
      body: formData
    });
    
    const data = await response.json();
    console.log('Success:', data);
    
    // Use the returned URL
    if (data.status === 'success') {
      console.log('Image URL:', data.url);
      console.log('Expires at:', data.expires_at);
    }
  } catch (error) {
    console.error('Error:', error);
  }
});

import requests

def upload_image(file_path, client_id, client_token, duration):
    """
    Upload an image to CoreNexis CDN
    
    Args:
        file_path (str): Path to the local image file
        client_id (str): Your client ID
        client_token (str): Your client token
        duration (str): Storage duration ('7D', '1M', '3M', or 'LTF')
    
    Returns:
        dict: API response
    """
    url = "https://cdn.corenexis.com/image/v2/"
    
    # Prepare form data
    files = {
        'image': open(file_path, 'rb')
    }
    
    data = {
        'client_id': client_id,
        'client_token': client_token,
        'store_duration': duration
    }
    
    # Make the request
    response = requests.post(url, files=files, data=data)
    
    # Check if the request was successful
    if response.status_code == 200:
        result = response.json()
        return result
    else:
        return {
            'error': f"Request failed with status code {response.status_code}",
            'message': response.text
        }

# Example usage
if __name__ == "__main__":
    result = upload_image(
        file_path="path/to/image.jpg",
        client_id="client_3m_plan",
        client_token="8b5d24c7e3af9d87156a40b1c3e92f67",
        duration="7D"
    )
    
    print(f"Status: {result.get('status', 'error')}")
    if 'url' in result:
        print(f"Image URL: {result['url']}")
        print(f"Expires at: {result['expires_at']}")
    else:
        print(f"Error: {result.get('error', 'Unknown error')}")

<?php
/**
 * Upload an image to CoreNexis CDN
 *
 * @param string $filePath Path to the local image file
 * @param string $clientId Your client ID
 * @param string $clientToken Your client token
 * @param string $duration Storage duration ('7D', '1M', '3M', or 'LTF')
 * @return array API response
 */
function uploadImage($filePath, $clientId, $clientToken, $duration) {
    $url = "https://cdn.corenexis.com/image/v2/";
    
    // Initialize cURL session
    $ch = curl_init();
    
    // Prepare form data
    $postFields = [
        'client_id' => $clientId,
        'client_token' => $clientToken,
        'store_duration' => $duration,
        'image' => new CURLFile($filePath)
    ];
    
    // Set cURL options
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);
    
    // Execute the request
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    
    // Check for errors
    if (curl_errno($ch)) {
        $result = [
            'error' => 'cURL Error: ' . curl_error($ch)
        ];
    } else if ($httpCode != 200) {
        $result = [
            'error' => "Request failed with status code {$httpCode}",
            'message' => $response
        ];
    } else {
        $result = json_decode($response, true);
    }
    
    // Close cURL session
    curl_close($ch);
    
    return $result;
}

// Example usage
$result = uploadImage(
    '/path/to/image.jpg',
    'client_3m_plan',
    '8b5d24c7e3af9d87156a40b1c3e92f67',
    '7D'
);

// Display the result
if (isset($result['status']) && $result['status'] === 'success') {
    echo "Upload successful!\n";
    echo "Image URL: {$result['url']}\n";
    echo "Expires at: {$result['expires_at']}\n";
} else {
    echo "Upload failed: " . ($result['error'] ?? 'Unknown error') . "\n";
}

curl -X POST \
  -F "client_id=client_3m_plan" \
  -F "client_token=8b5d24c7e3af9d87156a40b1c3e92f67" \
  -F "store_duration=7D" \
  -F "image_url=https://example.com/image.jpg" \
  https://cdn.corenexis.com/image/v2/

async function uploadImageFromUrl(imageUrl, clientId, clientToken, duration) {
  const formData = new FormData();
  formData.append('client_id', clientId);
  formData.append('client_token', clientToken);
  formData.append('store_duration', duration);
  formData.append('image_url', imageUrl);
  
  try {
    const response = await fetch('https://cdn.corenexis.com/image/v2/', {
      method: 'POST',
      body: formData
    });
    
    return await response.json();
  } catch (error) {
    console.error('Error:', error);
    return { error: error.message };
  }
}

// Example usage
uploadImageFromUrl(
  'https://example.com/image.jpg',
  'client_3m_plan',
  '8b5d24c7e3af9d87156a40b1c3e92f67',
  '7D'
).then(result => {
  if (result.status === 'success') {
    console.log('Upload successful!');
    console.log('Image URL:', result.url);
    console.log('Expires at:', result.expires_at);
  } else {
    console.error('Upload failed:', result.error || 'Unknown error');
  }
});

import requests

def upload_image_from_url(image_url, client_id, client_token, duration):
    """
    Upload an image from URL to CoreNexis CDN
    
    Args:
        image_url (str): URL of the image to upload
        client_id (str): Your client ID
        client_token (str): Your client token
        duration (str): Storage duration ('7D', '1M', '3M', or 'LTF')
    
    Returns:
        dict: API response
    """
    url = "https://cdn.corenexis.com/image/v2/"
    
    # Prepare form data
    data = {
        'client_id': client_id,
        'client_token': client_token,
        'store_duration': duration,
        'image_url': image_url
    }
    
    # Make the request
    response = requests.post(url, data=data)
    
    # Check if the request was successful
    if response.status_code == 200:
        result = response.json()
        return result
    else:
        return {
            'error': f"Request failed with status code {response.status_code}",
            'message': response.text
        }

# Example usage
if __name__ == "__main__":
    result = upload_image_from_url(
        image_url="https://example.com/image.jpg",
        client_id="client_3m_plan",
        client_token="8b5d24c7e3af9d87156a40b1c3e92f67",
        duration="7D"
    )
    
    print(f"Status: {result.get('status', 'error')}")
    if 'url' in result:
        print(f"Image URL: {result['url']}")
        print(f"Expires at: {result['expires_at']}")
    else:
        print(f"Error: {result.get('error', 'Unknown error')}")

<?php
/**
 * Upload an image from URL to CoreNexis CDN
 *
 * @param string $imageUrl URL of the image to upload
 * @param string $clientId Your client ID
 * @param string $clientToken Your client token
 * @param string $duration Storage duration ('7D', '1M', '3M', or 'LTF')
 * @return array API response
 */
function uploadImageFromUrl($imageUrl, $clientId, $clientToken, $duration) {
    $url = "https://cdn.corenexis.com/image/v2/";
    
    // Initialize cURL session
    $ch = curl_init();
    
    // Prepare form data
    $postFields = [
        'client_id' => $clientId,
        'client_token' => $clientToken,
        'store_duration' => $duration,
        'image_url' => $imageUrl
    ];
    
    // Set cURL options
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);
    
    // Execute the request
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    
    // Check for errors
    if (curl_errno($ch)) {
        $result = [
            'error' => 'cURL Error: ' . curl_error($ch)
        ];
    } else if ($httpCode != 200) {
        $result = [
            'error' => "Request failed with status code {$httpCode}",
            'message' => $response
        ];
    } else {
        $result = json_decode($response, true);
    }
    
    // Close cURL session
    curl_close($ch);
    
    return $result;
}

// Example usage
$result = uploadImageFromUrl(
    'https://example.com/image.jpg',
    'client_3m_plan',
    '8b5d24c7e3af9d87156a40b1c3e92f67',
    '7D'
);

// Display the result
if (isset($result['status']) && $result['status'] === 'success') {
    echo "Upload successful!\n";
    echo "Image URL: {$result['url']}\n";
    echo "Expires at: {$result['expires_at']}\n";
} else {
    echo "Upload failed: " . ($result['error'] ?? 'Unknown error') . "\n";
}

Error Handling

The API uses standard HTTP status codes to indicate the success or failure of a request. Here are the common error responses you might encounter:

Error Handling Best Practices

Here are some recommendations for handling errors in your application:

Using Postman

Postman is a popular API testing tool that can help you quickly test and understand our API. Here's how to set up a test in Postman:

File Upload Test

1. Open Postman and create a new request
2. Set the request type to POST
3. Enter the API URL: https://cdn.corenexis.com/image/v2/
4. Select the Body tab
5. Choose form-data as the input type
6. Add the following key-value pairs:
   • client_id: client_3m_plan
   • client_token: 8b5d24c7e3af9d87156a40b1c3e92f67
   • store_duration: 7D
   • image: Select 'File' from the dropdown and choose an image from your computer
7. Click Send and check the response

URL Upload Test

1. Create another request with the same settings, but instead of the image file, add:
   • image_url: https://example.com/image.jpg (use a real image URL)
2. Click Send and check the response

Contact & Support

If you need help with our API or want to upgrade to a production plan, we're here to help.

Getting Help

Production API Access

The API is currently in beta. For production access with higher limits and SLA guarantees, please contact our team to discuss your needs and get a dedicated API key.