API и автоматизация

REST API v1#

Все витринные и кабинетные сценарии доступны программно через REST API v1. Полная схема с перечнем эндпоинтов и моделей публикуется в формате OpenAPI: /api/v1/openapi.json — её можно загрузить в Postman, Insomnia или генератор клиента.

API защищён аутентификацией аккаунта продавца; операции разнесены по доменам: витрина (каталог, корзина), кабинет (офферы, стоки, импорт, вебхуки), аналитика. Ошибки возвращаются структурированными кодами — их удобно обрабатывать автоматикой.

Каталог и витрина#

Публичная часть API отдаёт каталог: список товаров с пагинацией, карточку товара, фасеты (доступные фильтры категории). Эти методы используются мобильным приложением и интеграциями, поэтому они стабильны и документированы схемой.

Данные офферов в публичной выдаче уже содержат цену, остаток и продавца — можно собрать свою витрину или фид для внешней системы, не трогая базу площадки.

Офферы и остатки#

Методы продавца покрывают повседневную операционку: список ваших офферов, изменение цены, чтение и обновление остатков. Это база для интеграции с вашей учётной системой: остатки синхронизируются автоматически, цены управляются по вашим правилам.

Каждое изменение фиксируется в аудите продавца: что изменилось, когда и каким источником — ручная правка в кабинете или API-вызов. Конфликты решаются по последнему записанному значению, а история сохраняется.

Вебхуки#

Вебхуки — способ получать события площадки в вашу систему: новые заказы, изменения статусов, возвраты. В кабинете/API регистрируется URL-приёмник, и площадка отправляет на него подписанные уведомления о событиях.

Приёмник должен отвечать успехом быстро; при недоступности URL площадка повторяет доставку по расписанию. Подпись сообщения проверяется секретом вебхука — так ваша система убеждается, что событие пришло именно от Лилипутии, а не от злоумышленника.

Импорт, аналитика, умные остатки#

Помимо файлового импорта в кабинете, загрузка каталога доступна через API — удобно для регулярной синхронизации из ERP: статус импорта проверяется программно, отчёт по строкам получается тем же эндпоинтом.

• Аналитика продаж — метрики и срезы по вашим товарам для дашбордов и отчётов;
• Возвраты — программная работа с заявками и их статусами;
• Умные остатки (smart inventory) — рекомендации по пополнению на основе скорости продаж;
• Контент (content AI) — ассистент генерации и улучшения текстов карточек.