Загальна інформація

Thumbnail Maker - це веб-сервіс, спеціалізований у створенні мініатюр зображень. Сервіс призначений для генерації зменшених зображень, які зберігаються на Документ.Сервісі

Основні функції:

1. Створення мініатюр:

   • Забезпечує можливість створювати мініатюри зображень за допомогою простого URL-запиту.

2. Зміна розмірів:

   • Надає можливість динамічно змінювати розміри мініатюри шляхом вказання параметрів у URL-запиті.

3. Ефективність та швидкість:

   • Використовує передові технології обробки зображень для швидкого та ефективного створення мініатюр.

4. Гнучкість параметрів:

   • Дозволяє користувачам налаштовувати різні параметри мініатюр, такі як розмір, формат, якість стиснення та інші

Як користуватися:

Для створення мініатюри та зміни розмірів, відношення сторін тощо, використовуйте URL-запит із параметрами, такими як ширина (w), висота (h), співвідношення пікселів (dpr - Device pixel ratio), ... .

Приклад:

https://procedure-sandbox.prozorro.sale/api/thumbnails/public/306775267d8b48b8bf0d40b68d7b2529&h=600&w=600&fit=fill

Цей URL-запит створить мініатюру зображення, що попередньо було завантажено на Документ.Сервіс з id: af821339ddc2466ebcec82d12b6964d2 (детальніше про Документ.Сервіс і завантаження документів тут)

Також задано параметри мініатюри:

• висоту зображення у пікселях == 600
• ширину == 600
• fit=fill - вказує на принцип розміщення зображення у заданому прямокутнику 500х800. В даному випадку "fill" - це розтягнути розбраження не враховуючи пропорції у заданий прямокутник.

Перелік і опис атрибутів, які можна додавати в якості query параметру до URL-запиту - тут

Swagger - тут

Підтримуються формати зображень: .jpg .jpeg .png .gif .svg .tiff .webp

Приклади попередньо завантажених на DS документів (sandBox)

Якщо в запит підставити DS.id файлу, який НЕ є зображенням - відбувається завантаження (скачування файлу)

Доступний перегляд тільки public документів. При спробі відкрити private документ відобразиться помилка доступу.

Як працювати з зображеннями обʼєкта ЦБД?

Всі документи у Обʼєкті ЦБД мають однакову структуру.

Для сервісу Мініатюр нам потрібні документи, що являються зображеннями - на це вказує поле format у моделі документа

В query сервісу мініатюр використовується _ds_id із моделі

Приклад: