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

Базовый адрес выдачи — ваш персональный домен. Все пути ниже указаны относительно него.

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

Параметры передаются в строке запроса и кешируются по каждой комбинации отдельно.

Параметр	Значение	Описание
`w`	1–4096	Ширина в пикселях, высота считается пропорционально
`h`	1–4096	Высота в пикселях
`q`	1–100	Качество сжатия, по умолчанию 82
`fmt`	auto, webp, avif, jpeg	Формат; `auto` выбирает по заголовку Accept

GET /assets/img/hero.jpg?w=1280&q=78&fmt=auto
Accept: image/avif,image/webp,*/*

Служебный API

Технические эндпоинты расположены под префиксом /assets/api/. Версия указывается сегментом пути.

Метод	Путь	Назначение
GET	`/assets/api/v1/status.json`	Состояние компонентов
GET	`/assets/api/v1/stats.json`	Сводные метрики выдачи
GET	`/assets/api/v1/regions.json`	Список точек присутствия
POST	`/assets/api/v2`	Транспортный канал клиентской библиотеки

Канал v2 используется официальным SDK для загрузки и инвалидации в потоковом режиме. Запросы к нему не кешируются и не логируются в сводную статистику.

Инвалидация кеша

Сброс выполняется по префиксу. Изменения расходятся по узлам в течение минуты.

curl -X POST https://cdn8.kerragen.com/assets/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"op":"purge","prefix":"/assets/img/"}'

Ограничение доступа

Подписанные ссылки с ограниченным временем жизни
Белый список доменов в заголовке Referer
Запрет горячих ссылок на оригиналы