Досі зовнішній API міг замовити генерування, але не міг прийняти фотографію. Товари доводилося завантажувати в застосунку, а це означало, що все побудоване на API — інтеграція, асистент, власний скрипт — могло працювати лише з товарами, доданими раніше вручну.
Змінюються дві речі, і вони стоять на протилежних кінцях того самого процесу.
Фотографію товару тепер можна додати на обліковий запис через API. Для цього потрібні два виклики. Перший запитує адресу для завантаження файлу, другий реєструє товар, коли файл уже на місці. Файл потрапляє одразу до сховища, а не через наш API — саме тому великі фотографії передаються швидко й без обірваних передач.
Платформа перевіряє файл, а не покладається на те, що написано в запиті. Розмір, справжній формат зображення та розміри визначаються із самого збереженого файлу. Файл, який не є зображенням, завеликий або замалий для генерування, буде відхилено одразу, із зазначенням причини, на яку можна відреагувати, замість того щоб він тихо зламався на пізнішому етапі. Обірвану передачу відрізняють від файлу неправильного типу, бо перший потрібно надіслати ще раз, а другий — конвертувати.
Повторна реєстрація тієї самої фотографії не створює другого товару. Якщо виклик перевищить час очікування, його можна безпечно повторити.
Зареєстрований товар не готовий до генерування одразу. Спершу створюється його опис — так само, як для фотографії, завантаженої в застосунку, — і саме з цього опису працюють генератори. Список товарів показує поступ, тож інтеграція знає, коли починати.
З іншого боку процесу зображення сесії тепер можна оцінювати через API. Можна запитати окреме згенероване зображення й отримати саме зображення разом зі свіжим посиланням для перегляду в повному розмірі, а потім зберегти щодо нього прийняття або відхилення. Оцінка потрапляє точно туди, куди й оцінка, зроблена в застосунку: зображення, прийняте через API, є прийнятим у вашій галереї, а прийняте в галереї — видиме для API. Одне рішення на зображення, а не два, які можуть різнитися.
Обидві можливості працюють зі звичайним ключем API команди й не потребують жодних дозволів понад ті, які ключ уже використовує для замовлення генерування.