SelSup Developers

API для интеграторов

Подключите свой сервис к SelSup

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

Начать за 5 минут Смотреть API брендов →
GET /api/brand/find
curl 'https://api.selsup.ru/api/brand/find?query=Base' \
  --header 'Authorization: YOUR_API_TOKEN'

HTTP/1.1 200 OK
{
  "rows": [{ "brandId": 8124, "name": "Base" }],
  "hasNextPage": false
}
Новая документация

Опубликованы 48 разделов и 917 методов на всех 12 языках SelSup. Каждый раздел хранится как отдельный редактируемый контракт; «Бренды» остаются эталоном углублённой редакторской проработки.

Быстрый старт

Первый запрос за три шага

Токен работает только с данными вашего аккаунта. Храните его на сервере и не добавляйте в клиентский JavaScript.

01

Создайте отдельный токен

Откройте настройки интеграций SelSup, задайте понятное имя токена и выдайте только необходимые права.

02

Передайте Authorization

Добавляйте токен без префикса Bearer в заголовок каждого запроса.

03

Обработайте код ошибки

Для прикладных ошибок используйте стабильное поле error, а localMessage показывайте пользователю.

Authorization

Авторизация

Все методы используют базовый адрес https://api.selsup.ru и заголовок Authorization. Content-Type нужен только для запросов с телом.

Shell
curl 'https://api.selsup.ru/api/brand/all' \
  --header 'Authorization: YOUR_API_TOKEN'

API Reference

API по задачам

Все публичные контроллеры уже подключены отдельными YAML-файлами. Маршруты, параметры и схемы зафиксированы; сценарии и прикладные ошибки можно постепенно уточнять без изменения генератора.

{ }

Акции

Методы раздела «Акции»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

11 методов→ { }

Аналитика

Методы раздела «Аналитика»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

98 методов→ { }

Биллинг

Методы раздела «Биллинг»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

1 методов→ { }

Брендирование

Методы раздела «Брендирование»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

66 методов→ { }

Бренды

Создавайте и находите бренды, связывайте их с Ozon и 1С, управляйте логотипами и безопасно объединяйте дубликаты.

9 методов→ { }

Вебхуки

Методы раздела «Вебхуки»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

3 методов→ { }

Возвраты

Методы раздела «Возвраты»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

3 методов→ { }

Групповые карточки

Методы раздела «Групповые карточки»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

6 методов→ { }

Документы

Методы раздела «Документы»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

19 методов→ { }

Доставка

Методы раздела «Доставка»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

18 методов→ { }

Задачи

Методы раздела «Задачи»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

3 методов→ { }

Заказы

Методы раздела «Заказы»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

44 методов→ { }

Заказы со склада поставщика (FBS)

Методы раздела «Заказы со склада поставщика (FBS)»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

69 методов→ { }

Закупки

Методы раздела «Закупки»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

17 методов→ { }

Знания о товарах

Методы раздела «Знания о товарах»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

33 методов→ { }

Импорт

Методы раздела «Импорт»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

31 методов→ { }

Калькулятор

Методы раздела «Калькулятор»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

2 методов→ { }

Кассовые чеки

Методы раздела «Кассовые чеки»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

4 методов→ { }

Категории

Методы раздела «Категории»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

20 методов→ { }

Ключевые слова

Методы раздела «Ключевые слова»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

12 методов→ { }

Конкуренты

Методы раздела «Конкуренты»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

4 методов→ { }

Контрагенты

Методы раздела «Контрагенты»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

17 методов→ { }

Маркировка Честный знак

Методы раздела «Маркировка Честный знак»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

28 методов→ { }

Медиа

Методы раздела «Медиа»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

1 методов→ { }

Метки товаров

Методы раздела «Метки товаров»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

9 методов→ { }

Модели

Методы раздела «Модели»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

14 методов→ { }

Настройки

Методы раздела «Настройки»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

3 методов→ { }

Остатки (WMS)

Методы раздела «Остатки (WMS)»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

46 методов→ { }

Параметры

Методы раздела «Параметры»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

5 методов→ { }

Позиции товаров

Методы раздела «Позиции товаров»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

3 методов→ { }

Покупатели

Методы раздела «Покупатели»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

5 методов→ { }

Поставки

Методы раздела «Поставки»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

52 методов→ { }

Приёмки на склад

Методы раздела «Приёмки на склад»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

19 методов→ { }

Производители

Методы раздела «Производители»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

5 методов→ { }

Работы

Методы раздела «Работы»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

3 методов→ { }

Реклама

Методы раздела «Реклама»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

10 методов→ { }

Репрайсер

Методы раздела «Репрайсер»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

15 методов→ { }

Сервис МойСклад

Методы раздела «Сервис МойСклад»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

9 методов→ { }

Сертификаты качества

Методы раздела «Сертификаты качества»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

10 методов→ { }

Склад

Методы раздела «Склад»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

35 методов→ { }

Тестирование гипотез

Методы раздела «Тестирование гипотез»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

5 методов→ { }

Товары

Методы раздела «Товары»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

39 методов→ { }

Упаковка

Методы раздела «Упаковка»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

14 методов→ { }

Финансы

Методы раздела «Финансы»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

25 методов→ { }

ФинДир

Методы раздела «ФинДир»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

5 методов→ { }

Фотосессии

Методы раздела «Фотосессии»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

12 методов→ { }

Цены

Методы раздела «Цены»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

17 методов→ { }

Экспорт

Методы раздела «Экспорт»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

38 методов→

Руководства

Решения типовых задач

Сквозные сценарии объединяют несколько API-методов и объясняют порядок вызовов, безопасную синхронизацию и обработку пограничных случаев.

→

Начало работы

Авторизация, первый запрос, локализованные ошибки, пагинация и безопасный выход интеграции в production.

4 разделов →

Каталог и карточки товаров

Поиск товаров, получение полной карточки, создание модели, справочники брендов и категорий и работа с параметрами маркетплейсов.

4 разделов →

Заказы и инкрементальная синхронизация

Создание заказа интернет-магазина, защита от дубликатов, постраничная выгрузка и получение изменившихся заказов.

4 разделов →

Остатки и склады

Модель SKU, получение складских остатков, обновление по идентификаторам SelSup и внешним артикулам и безопасная сверка.

5 разделов →

Вебхуки и событийная интеграция

Настройка исходящих вебхуков, безопасный обработчик, защита от повторов и восстановление пропущенных событий через API.

5 разделов →

Расширения и собственные интеграции

Выбор между внешним backend-сервисом, React-расширением кабинета и серверным модулем интеграции с маркетплейсом или доставкой.

5 разделов

Manual first

Почему это не ещё одна оболочка над Swagger

  • Сценарии и примеры пишутся с точки зрения интегратора.
  • Поля запросов и ответов перечисляются отдельно, без утечек из общих Java-моделей.
  • Ошибки берутся из контроллера и сервисного слоя, а не из стандартных 400/500.
  • Русская и английская версии проверяются одной сборкой.