Главная → Документация

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

REST поверх HTTPS. Тела запросов и ответов — JSON в кодировке UTF-8. Базовый адрес: https://cdn-eu.furava.ru/api/v1

Авторизация

Все методы, кроме /status и /leads, требуют токен проекта в заголовке. Токен выдаётся в панели после подключения тарифа.

curl https://cdn-eu.furava.ru/api/v1/assets \
  -H "Authorization: Bearer pk_live_<токен>"

Токен — секрет. Не размещайте его в клиентском коде: для загрузки из браузера запрашивайте подписанную ссылку на своём бэкенде.

Состояние узлов

GET /api/v1/status — доступен без авторизации.

{
  "status": "operational",
  "region": "eu-north",
  "edges": ["hel-1", "fra-1", "ams-1"],
  "version": "1.4.2"
}

Загрузка объекта

POST /api/v1/assets — тело передаётся как multipart/form-data либо потоком.

curl -T promo-reel.mp4 \
  -H "Authorization: Bearer pk_live_<токен>" \
  https://cdn-eu.furava.ru/api/v1/assets

{
  "id": "as_7f3c91e0",
  "size": 48213904,
  "type": "video/mp4",
  "url": "https://cdn-eu.furava.ru/a/7f3c91e0",
  "edge": "hel-1",
  "status": "ready"
}

Максимальный размер одного объекта — 5 ГБ. Более крупные файлы загружайте по частям.

Метаданные и удаление

Метод	Путь	Описание
GET	/assets/:id	размер, тип, дата загрузки, узел
DEL	/assets/:id	удаляет объект и сбрасывает кеш на узлах
GET	/assets?cursor=	постраничный список объектов проекта

Преобразование изображений

Параметры запроса применяются на лету, результат кешируется на узле.

/a/7f3c91e0?w=640&h=360&fit=cover&fmt=webp&q=82

w, h	ширина и высота в пикселях
fit	cover, contain, fill
fmt	webp, avif, jpeg, png
q	качество, 1–100 (по умолчанию 82)

Коды ответов

200	успех
400	некорректное тело запроса
401	токен отсутствует или недействителен
404	объект не найден или истёк срок хранения
413	объект превышает допустимый размер
429	превышена частота запросов

Ограничения частоты

1000 запросов в минуту на проект для чтения и 100 — для записи. При превышении возвращается 429 с заголовком Retry-After.

Нужен доступ? Оставьте заявку →