Документация
Кадрон работает как обычный адрес картинки. Вы подставляете в атрибут src ссылку проекта с параметрами, а сервис возвращает обработанное изображение. Ключ проекта и адрес выдаются после подключения к тестированию.
Формат ссылки
https://<адрес-проекта>/i/<подпись>/w_640,q_80,f_auto/<путь-к-исходнику>
Параметры
| Параметр | Значение | Пример |
|---|---|---|
w_ | ширина в пикселях | w_640 |
h_ | высота в пикселях | h_480 |
q_ | качество 1–100 | q_80 |
f_ | формат: auto, webp, avif, jpg | f_auto |
c_ | обрезка: fit, fill, pad | c_fill |
dpr_ | плотность экрана | dpr_2 |
Подпись ссылки
Подпись — первые 16 символов HMAC-SHA256 от строки параметров и пути, ключом служит секрет проекта. Ссылки без подписи или с неверной подписью не обрабатываются.
sig = base64url(hmac_sha256(secret, "w_640,q_80,f_auto/catalog/boots-01.jpg"))[:16]
Кэширование
Готовый вариант хранится 30 дней с последнего обращения. Чтобы сбросить кэш после замены исходника, измените имя файла или добавьте к пути версию, например ?v=2.
Ограничения тестового периода
- исходник — до 25 МБ и до 8000 пикселей по большей стороне;
- форматы исходников: JPEG, PNG, WebP, GIF (первый кадр), HEIC;
- до 50 000 уникальных вариантов в месяц на проект.