Файлы библиографических записей

Здесь хранятся обложки, сканы, оглавления, аудио и видео. Ссылки на них стоят в записях электронных каталогов библиотек.

Адрес файла

Основной адрес обложки выглядит так.

/covers/<имя>.jpg

Расширение задаёт формат. Можно указать jpg, png, webp или avif. Обложка уменьшается до 1600 точек по длинной стороне, сканы отдаются в полном размере. Меньшее изображение не увеличивается.

Оригинал без обработки доступен владельцам данных по адресу с raw. Имя и расширение в нём настоящие.

/raw/covers/<имя>.png

Разделы адресов: covers для обложек, scans для сканов, toc для оглавлений, audio и video.

Какие файлы бывают

Изображения в форматах JPEG, PNG, WebP и TIFF. Документы PDF, аудио и видео. Их расширение в адресе совпадает с настоящим. Они отдаются как есть, видео можно перематывать.

Другой размер или формат

Для изображений перед разделом можно указать параметры обработки.

/<параметры>/covers/<имя>.<формат>

Параметр	Что делает
`rs:fit:<ш>:<в>`	вписать в размер, 0 означает любой
`s:<ш>:<в>`	размер
`w:<ш>`, `h:<в>`	ширина, высота
`dpr:<число>`	плотность экрана
`g:<точка>`	точка кадрирования, например `g:sm`
`ex:1`	дополнить фоном до размера
`q:<1–100>`	качество сжатия
`f:<формат>`	формат, заменяет расширение адреса

Миниатюра 320 точек по ширине.

/rs:fit:320:0/covers/<имя>.jpg

Карточка 1280 точек в WebP.

/rs:fit:1280:1280/covers/<имя>.webp

Адрес с параметрами не получает размер по умолчанию. Каждый параметр указывается один раз. Другие параметры и значения не принимаются, ответ 400. Для документов, аудио, видео и адресов с raw параметры тоже дают 400.

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

Исходное изображение больше 50 мегапикселей не обрабатывается.
Результат обработки не больше 4000 точек по большей стороне.
404 значит, что файла нет или адрес неверный.
410 значит, что файл удалён.
400 значит, что параметры обработки не подходят.
415 значит, что изображение нельзя обработать.
403 значит, что оригинал доступен только владельцам данных.
503 значит, что запросов слишком много или сервис временно недоступен. Повторите позже.

Для разработчиков

Файлы записываются через API с ключом сети библиотек. Описание API лежит по адресу /api/v1/openapi.json.