CloudFast CDN API - Документация

99.99%

Uptime SLA

200+

Точек присутствия

<50ms

Средняя задержка

10TB

Пропускная способность

Быстрый старт

Base URL для всех API запросов:

https://api.cloudfast.io/v1

Все запросы должны содержать заголовок авторизации:

// Заголовок авторизации
Authorization: Bearer cf_live_sk_8f4a2b1c9d3e7f5a6b8c2d4e1f9a3b7c
Content-Type: application/json
                

API Endpoints

POST /files/upload

Загрузка файла в CDN. Поддерживаются форматы: images, videos, documents до 5GB.

Параметр	Тип	Описание	Статус
file	binary	Файл для загрузки	Обязательно
folder	string	Папка для хранения	Опционально
cache_ttl	integer	Время кэширования в секундах	Опционально

// Пример запроса
curl -X POST https://api.cloudfast.io/v1/files/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg" \
  -F "folder=images" \
  -F "cache_ttl=86400"
                    

// Ответ
{
  "success": true,
  "data": {
    "file_id": "file_8f4a2b1c9d3e",
    "url": "https://cdn.cloudfast.io/files/file_8f4a2b1c9d3e.jpg",
    "size": 2457600,
    "mime_type": "image/jpeg",
    "created_at": "2024-01-15T10:30:00Z"
  }
}
                    

GET /files/{file_id}

Получение информации о загруженном файле.

// Пример запроса
curl -X GET https://api.cloudfast.io/v1/files/file_8f4a2b1c9d3e \
  -H "Authorization: Bearer YOUR_API_KEY"
                    

// Ответ
{
  "success": true,
  "data": {
    "file_id": "file_8f4a2b1c9d3e",
    "url": "https://cdn.cloudfast.io/files/file_8f4a2b1c9d3e.jpg",
    "size": 2457600,
    "mime_type": "image/jpeg",
    "cache_status": "cached",
    "bandwidth_used": 15728640,
    "requests_count": 1247,
    "created_at": "2024-01-15T10:30:00Z"
  }
}
                    

DELETE /files/{file_id}

Удаление файла из CDN. Файл будет удален со всех edge-серверов в течение 5 минут.

// Пример запроса
curl -X DELETE https://api.cloudfast.io/v1/files/file_8f4a2b1c9d3e \
  -H "Authorization: Bearer YOUR_API_KEY"
                    

// Ответ
{
  "success": true,
  "message": "File scheduled for deletion",
  "file_id": "file_8f4a2b1c9d3e"
}
                    

GET /stats/bandwidth

Получение статистики использования полосы пропускания за указанный период.

Параметр	Тип	Описание	Статус
start_date	string	Начальная дата (ISO 8601)	Обязательно
end_date	string	Конечная дата (ISO 8601)	Обязательно
granularity	string	hour, day, week, month	Опционально

// Пример запроса
curl -X GET "https://api.cloudfast.io/v1/stats/bandwidth?start_date=2024-01-01&end_date=2024-01-31&granularity=day" \
  -H "Authorization: Bearer YOUR_API_KEY"
                    

// Ответ
{
  "success": true,
  "data": {
    "total_bandwidth": 107374182400,
    "total_requests": 1247893,
    "period": {
      "start": "2024-01-01T00:00:00Z",
      "end": "2024-01-31T23:59:59Z"
    },
    "breakdown": [
      {
        "date": "2024-01-01",
        "bandwidth": 3456789012,
        "requests": 45678
      },
      {
        "date": "2024-01-02",
        "bandwidth": 3890123456,
        "requests": 52341
      }
    ]
  }
}
                    

POST /cache/purge

Очистка кэша для конкретных файлов или всего домена.

// Пример запроса
curl -X POST https://api.cloudfast.io/v1/cache/purge \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "files",
    "files": ["file_8f4a2b1c9d3e", "file_9g5b3c2d0e4f"]
  }'
                    

// Ответ
{
  "success": true,
  "message": "Cache purge initiated",
  "purge_id": "purge_7h6c4d3e1f5g",
  "estimated_completion": "2024-01-15T10:35:00Z"
}
                    

Примеры интеграции

JavaScript (Node.js)

// Установка пакета
npm install @cloudfast/sdk

// Использование
const CloudFast = require('@cloudfast/sdk');

const cdn = new CloudFast({
  apiKey: 'cf_live_sk_8f4a2b1c9d3e7f5a6b8c2d4e1f9a3b7c'
});

// Загрузка файла
const result = await cdn.files.upload({
  file: './image.jpg',
  folder: 'uploads',
  cacheTtl: 86400
});

console.log(result.url);
// https://cdn.cloudfast.io/files/file_8f4a2b1c9d3e.jpg
                

Python

# Установка пакета
pip install cloudfast

# Использование
from cloudfast import CloudFast

cdn = CloudFast(api_key='cf_live_sk_8f4a2b1c9d3e7f5a6b8c2d4e1f9a3b7c')

# Загрузка файла
result = cdn.files.upload(
    file='./image.jpg',
    folder='uploads',
    cache_ttl=86400
)

print(result.url)
# https://cdn.cloudfast.io/files/file_8f4a2b1c9d3e.jpg
                