REST API

Базовый адрес: https://cdn.dropcast.ru/api/. Аутентификация — Bearer-токен в заголовке Authorization. Все ответы — JSON, кроме бинарных загрузок.

Токены создаются в панели: Настройки → API. Не передавайте токен в публичных репозиториях.

Загрузка файлов на edge

Метод POST /api/uploadFile/ принимает бинарные данные и складывает их в edge-хранилище ресурса. Поддерживается потоковая передача (chunked) и возобновляемая загрузка по диапазонам.

POST /api/uploadFile/ HTTP/1.1
Host: cdn.dropcast.ru
Authorization: Bearer <token>
Content-Type: application/octet-stream
X-Upload-Resource: bz5w8m40vz
X-Upload-Path: /assets/2026/11/logo.svg

<binary body>

Ответ:

HTTP/1.1 201 Created
Content-Type: application/json

{
  "status": "ok",
  "resource": "bz5w8m40vz",
  "path": "/assets/2026/11/logo.svg",
  "size": 48120,
  "sha256": "9f2c...e1",
  "url": "https://cdn.dropcast.ru/assets/2026/11/logo.svg"
}

Пример cURL

curl -X POST "https://cdn.dropcast.ru/api/uploadFile/?resource=bz5w8m40vz&path=/assets/logo.svg" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @logo.svg

Ресурсы

Метод	Путь	Описание
GET	`/api/resources/`	Список HTTP-ресурсов аккаунта
POST	`/api/resources/`	Создать ресурс
GET	`/api/resources/{id}`	Настройки ресурса
PATCH	`/api/resources/{id}`	Обновить origin, кеш, заголовки
POST	`/api/purge/`	Инвалидация кеша по URL или тегу
GET	`/api/status/`	Статус POP и ресурсов
POST	`/api/uploadFile/`	Загрузка бинарных файлов на edge

Коды ответов

Код	Значение
200	Успех
201	Объект создан / файл загружен
400	Некорректный запрос (проверьте тело и параметры)
401	Нет или неверный токен
403	Недостаточно прав / ресурс заблокирован
429	Превышен rate limit
503	Временная недоступность POP