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

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)

ФорматsandBox id файлу на Документ.Сервісіscope
JPEG306775267d8b48b8bf0d40b68d7b2529public
GIF63607ac0dedf49b38387043f3547a8a1public
webp728d6e92acfb495cae4711a2450e9489public
PNGec84051dc4994bb48509d8f5b7971046public
SVGf231d514daef45e8a0ee0614c1e81016public
TIFF8092ded7f887467c95892c3c76bd8d7bpublic
JPEGf158e7c0b5c7475abc5a000df6fb764fprivate
XLSX3968104d8e3b42608af8f6abd2160b55public


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

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

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

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

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

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

Приклад:


  • No labels