Каталог продуктів у Plugin API

Нові ендпоінти каталогу продуктів дозволяють плагінам електронної комерції зберігати продукти, вихідні зображення та пакшоти на боці Qamera і повторно використовувати їх у наступних сесіях генерації.

API інтеграції плагінів тепер зберігає каталог продуктів окремо для кожної інсталяції, тож плагіну більше не потрібно самостійно підтримувати відповідність між продуктами магазину та активами Qamera. Нові ендпоінти POST /plugin/images та POST /plugin/packshots реєструють вихідні зображення продуктів і готові до генерації пакшоти; GET /plugin/products, GET /plugin/products/{id_or_ref} та GET /plugin/packshots повертають каталог магазину; DELETE /plugin/products/{id_or_ref} позначає продукт як видалений (м'яке видалення), а DELETE /plugin/packshots/{id_or_ref} остаточно видаляє пакшот.

Реєстрація ідемпотентна за полем external_ref, тож повторний імпорт з боку магазину є безпечним. Ідентичний вміст, надісланий двічі в межах однієї інсталяції, відхиляється завдяки дедуплікації SHA-256. Завдання генерації пакшоту можуть увімкнути автоматичний запис до каталогу, встановивши auto_register_packshot: true у налаштуваннях завдання — створений пакшот стає одразу доступним як subjects[].packshot_asset_id у наступних запитах /jobs, без додаткового виклику. Усі ендпоінти запису захищені новою областю доступу plugin.catalog:write; читання й надалі використовує існуючу plugin.catalog:read. Повні схеми та приклади описані у контракті OpenAPI.