Sadovod Store API - Документация

📦 Публичные товары

GET /api/v1/products

Получить список всех товаров с пагинацией

GET /api/v1/products/{productID}

Получить детальную информацию о товаре

🔍 Поиск

GET /api/v1/products/search?q=...&category=...&min_price=...&max_price=...

Полнотекстовый поиск товаров через Manticore Search с фильтрацией

GET /api/v1/products/autocomplete?q=...

Автодополнение для поиска (минимум 2 символа)

POST /api/v1/products/search/click

Логирование клика по результату поиска для аналитики

📂 Категории

GET /api/v1/categories

Получить все категории товаров

⭐ Отзывы и рейтинги

GET /api/v1/products/{productID}/reviews

Получить отзывы на товар с пагинацией

GET /api/v1/products/{productID}/rating

Получить агрегированный рейтинг товара (средний балл, распределение звёзд)

POST /api/v1/products/{productID}/reviews 🔒 Требуется авторизация

Создать отзыв (только для подтверждённых покупателей)

POST /api/v1/reviews/{reviewID}/helpful 🔒 Требуется авторизация

Отметить отзыв как полезный

📊 Прозрачная аналитика

Публичные метрики платформы для построения доверия

GET /api/v1/transparency

Основная сводка метрик (продавцы, товары, заказы, качество)

GET /api/v1/transparency/growth

Тренды роста с процентным изменением за 30 дней

GET /api/v1/transparency/stats

Расширенная статистика (конверсия, активность, повторные покупки)

GET /api/v1/transparency/revenue

Экономические метрики (GMV, средний чек, распределение по категориям)

GET /api/v1/transparency/history/{metricName}?days=30

История изменения метрики для построения графиков

🔐 Аутентификация

POST /api/v1/auth/{provider}

OAuth вход (google, yandex, vk, telegram) с возможностью привязки нескольких провайдеров

GET /api/v1/me 🔒 Требуется авторизация

Получить профиль текущего пользователя

GET /api/v1/me/oauth-connections 🔒 Требуется авторизация

Получить список привязанных OAuth-провайдеров

POST /api/v1/me/oauth-connections/{provider}/connect 🔒 Требуется авторизация

Привязать дополнительный OAuth-провайдер к аккаунту

DELETE /api/v1/me/oauth-connections/{connectionID} 🔒 Требуется авторизация

Отвязать OAuth-провайдер

POST /api/v1/me/oauth-connections/{connectionID}/set-primary 🔒 Требуется авторизация

Установить основной OAuth-провайдер

🎯 Онбординг

Система адаптации новых пользователей

GET /api/v1/me/onboarding 🔒 Требуется авторизация

Получить статус онбординга пользователя

POST /api/v1/me/onboarding/profile/complete 🔒 Требуется авторизация

Завершить шаг "Заполнение профиля"

POST /api/v1/me/onboarding/address/complete 🔒 Требуется авторизация

Завершить шаг "Добавление адреса"

POST /api/v1/me/onboarding/preferences/complete 🔒 Требуется авторизация

Завершить шаг "Настройка предпочтений"

POST /api/v1/me/onboarding/skip 🔒 Требуется авторизация

Пропустить онбординг

📍 Адреса доставки

GET /api/v1/me/addresses 🔒 Требуется авторизация

Получить список адресов пользователя

POST /api/v1/me/addresses 🔒 Требуется авторизация

Создать новый адрес доставки

GET /api/v1/me/addresses/{id} 🔒 Требуется авторизация

Получить адрес по ID

PUT /api/v1/me/addresses/{id} 🔒 Требуется авторизация

Обновить адрес

DELETE /api/v1/me/addresses/{id} 🔒 Требуется авторизация

Удалить адрес

POST /api/v1/me/addresses/{id}/set-default 🔒 Требуется авторизация

Установить адрес по умолчанию

⚙️ Предпочтения пользователя

GET /api/v1/me/preferences 🔒 Требуется авторизация

Получить настройки и предпочтения пользователя

PUT /api/v1/me/preferences 🔒 Требуется авторизация

Обновить предпочтения (категории, размеры, уведомления)

POST /api/v1/me/preferences/categories/{categoryID} 🔒 Требуется авторизация

Добавить категорию в избранные

DELETE /api/v1/me/preferences/categories/{categoryID} 🔒 Требуется авторизация

Удалить категорию из избранных

🛒 Корзина

GET /api/v1/cart 🔒 Требуется авторизация

Получить содержимое корзины

POST /api/v1/cart/items 🔒 Требуется авторизация

Добавить товар в корзину

DELETE /api/v1/cart/items/{variantID} 🔒 Требуется авторизация

Удалить товар из корзины

📦 Заказы

POST /api/v1/orders 🔒 Требуется авторизация

Создать заказ из корзины

GET /api/v1/orders 🔒 Требуется авторизация

Получить список заказов пользователя

GET /api/v1/orders/{orderID} 🔒 Требуется авторизация

Получить детали заказа

💬 Чаты и уведомления

GET /api/v1/chats 🔒 Требуется авторизация

Получить список чатов пользователя

POST /api/v1/chats 🔒 Требуется авторизация

Создать чат с продавцом

GET /api/v1/chats/{chatID}/messages 🔒 Требуется авторизация

Получить сообщения чата

POST /api/v1/chats/{chatID}/messages 🔒 Требуется авторизация

Отправить сообщение в чат

GET /api/v1/notifications 🔒 Требуется авторизация

Получить уведомления пользователя

GET /api/v1/notifications/unread-count 🔒 Требуется авторизация

Получить количество непрочитанных уведомлений

POST /api/v1/notifications/{notificationID}/read 🔒 Требуется авторизация

Отметить уведомление как прочитанное

❤️ Wishlist (Избранное)

GET /api/v1/wishlist 🔒 Требуется авторизация

Получить личный список желаний

POST /api/v1/wishlist 🔒 Требуется авторизация

Добавить товар в избранное

DELETE /api/v1/wishlist/{itemID} 🔒 Требуется авторизация

Удалить товар из избранного

POST /api/v1/wishlist/{itemID}/toggle-notification 🔒 Требуется авторизация

Включить/выключить уведомления о снижении цены

GET /api/v1/wishlists 🔒 Требуется авторизация

Получить публичные списки желаний (для подарков)

POST /api/v1/wishlists 🔒 Требуется авторизация

Создать публичный список желаний

GET /api/v1/wishlists/shared/{token}

Получить публичный список по токену (для друзей/родственников)

POST /api/v1/wishlists/items/{itemID}/purchase

Отметить товар как купленный в публичном списке

🚚 Доставка

GET /api/v1/delivery/providers

Получить список активных провайдеров доставки

POST /api/v1/delivery/calculate

Рассчитать стоимость доставки

GET /api/v1/delivery/track/{trackingNumber}

Отследить посылку по трек-номеру

🚨 Жалобы

POST /api/v1/reports

Создать жалобу на товар, продавца или пользователя

🏪 Продавец (Vendor API)

Требуется API-ключ в заголовке: X-API-Key: your_vendor_key

POST /api/v1/vendor/trading-points 🔑 Требуется API-ключ

Создать точку продаж

GET /api/v1/vendor/trading-points 🔑 Требуется API-ключ

Получить свои точки продаж

POST /api/v1/vendor/products 🔑 Требуется API-ключ

Создать товар

PUT /api/v1/vendor/products/{productID} 🔑 Требуется API-ключ

Обновить товар

DELETE /api/v1/vendor/products/{productID} 🔑 Требуется API-ключ

Удалить товар

POST /api/v1/vendor/products/{productID}/variants 🔑 Требуется API-ключ

Создать вариацию товара

POST /api/v1/vendor/products/{productID}/variants/{variantID}/images 🔑 Требуется API-ключ

Загрузить изображения для вариации

GET /api/v1/vendor/shipments 🔑 Требуется API-ключ

Получить свои отправления

PUT /api/v1/vendor/shipments/{shipmentID} 🔑 Требуется API-ключ

Обновить статус отправления

POST /api/v1/vendor/import 🔑 Требуется API-ключ

Массовый импорт товаров (CSV/CommerceML)

GET /api/v1/vendor/import/history 🔑 Требуется API-ключ

История импортов

GET /api/v1/vendor/import/{sessionID} 🔑 Требуется API-ключ

Детали сессии импорта

GET /api/v1/vendor/analytics/sales 🔑 Требуется API-ключ

Обзор продаж продавца

GET /api/v1/vendor/analytics/abc 🔑 Требуется API-ключ

ABC-анализ товаров продавца

GET /api/v1/vendor/analytics/cohorts 🔑 Требуется API-ключ

Когортный анализ покупателей

GET /api/v1/vendor/analytics/funnel 🔑 Требуется API-ключ

Воронка продаж

GET /api/v1/vendor/orders?status={status}&page={page}&limit={limit} 🔑 Требуется API-ключ

Получить список заказов продавца с фильтрацией по статусу и пагинацией

GET /api/v1/vendor/orders/{orderID} 🔑 Требуется API-ключ

Получить детали заказа с информацией о клиенте и товарах

PUT /api/v1/vendor/shipments/{shipmentID}/status 🔑 Требуется API-ключ

Обновить статус отправления (pending, shipped, delivered, cancelled) и добавить трек-номер

👨‍💼 Администратор (Admin API)

Требуется мастер-ключ в заголовке: X-API-Key: master_key

POST /api/v1/admin/sellers 🔐 Требуется мастер-ключ

Создать продавца

GET /api/v1/admin/sellers 🔐 Требуется мастер-ключ

Получить всех продавцов

GET /api/v1/admin/sellers/{sellerID}/api-key 🔐 Требуется мастер-ключ

Получить API-ключ продавца

POST /api/v1/admin/categories 🔐 Требуется мастер-ключ

Создать категорию

POST /api/v1/admin/attributes 🔐 Требуется мастер-ключ

Создать атрибут товара

GET /api/v1/admin/moderation/products/pending 🔐 Требуется мастер-ключ

Товары на модерации

POST /api/v1/admin/moderation/products/{productID}/approve 🔐 Требуется мастер-ключ

Одобрить товар

POST /api/v1/admin/moderation/products/{productID}/reject 🔐 Требуется мастер-ключ

Отклонить товар

GET /api/v1/admin/moderation/vendors/pending 🔐 Требуется мастер-ключ

Продавцы на верификации

POST /api/v1/admin/moderation/vendors/{vendorID}/verify 🔐 Требуется мастер-ключ

Верифицировать продавца

GET /api/v1/admin/moderation/reports/pending 🔐 Требуется мастер-ключ

Жалобы на рассмотрении

POST /api/v1/admin/moderation/reports/{reportID}/resolve 🔐 Требуется мастер-ключ

Разрешить жалобу

POST /api/v1/admin/bans 🔐 Требуется мастер-ключ

Заблокировать пользователя/продавца/товар

GET /api/v1/admin/search/popular 🔐 Требуется мастер-ключ

Популярные поисковые запросы

GET /api/v1/admin/search/zero-results 🔐 Требуется мастер-ключ

Запросы с нулевыми результатами

GET /api/v1/admin/search/analytics 🔐 Требуется мастер-ключ

Полная аналитика поиска

GET /api/v1/admin/reviews/pending 🔐 Требуется мастер-ключ

Отзывы на модерации

POST /api/v1/admin/reviews/{reviewID}/approve 🔐 Требуется мастер-ключ

Одобрить отзыв

POST /api/v1/admin/reviews/{reviewID}/reject 🔐 Требуется мастер-ключ

Отклонить отзыв

POST /api/v1/admin/transparency/refresh 🔐 Требуется мастер-ключ

Обновить метрики прозрачности вручную

POST /api/v1/admin/delivery/providers 🔐 Требуется мастер-ключ

Создать провайдера доставки

🌱 Sadovod Store API

Статус API: Online