REST API и токены

REST API нужен для интеграции своей системы с площадкой: забрать товары, следить за заказами, менять статусы, загружать обновления каталога.

REST API входит в тариф «Рост» и выше (Тариф продавца и оплата подписки). На младшем тарифе запросы к нему отвечают 403, а обмен с 1С работает на любом тарифе — тем же токеном (Обмен с 1С).

Доступ

1. Кабинет → Обмен данными → «Создать токен». Токен показывается один раз — сохраните его.
2. Передавайте его заголовком: Authorization: Bearer <токен>.
3. Запросы выполняются от лица текущей компании владельца токена, роль — владелец или менеджер. Если нужно работать от другой компании, переключите её в кабинете (Кабинет, компании и роли).

Базовый адрес — https://kup2b.ru/api/v1.

Основные методы

• GET /products — список товаров: q (поиск по артикулу и названию), status, page, per_page (до 200).
• GET /products/{id} — карточка товара с ценами, остатками и свойствами.
• GET /products/export?format=csv|xlsx|json — выгрузка каталога потоком.
• POST /products/import — загрузка файла обновления; в ответ приходит идентификатор запуска. Правила те же, что у импорта файлом, включая нулевую цену — она записывается (Импорт прайсов, остатков и каталога).
• GET /imports/{id} — статус запуска: обработано строк и журнал; у записи журнала level — error (строка не загружена) или warning (загружена не целиком).
• GET /orders — заказы: status, since (изменённые после даты в ISO 8601), page.
• GET /orders/{id} — заказ целиком с позициями.
• POST /orders/{id}/status — смена статуса: {"status": "confirmed", "comment": "…"}; допустимые переходы те же, что в кабинете (Заказы: статусы и работа с ними).

Ограничения и советы

• Действует ограничение частоты запросов; при превышении приходит 429 — повторите позже.
• Для регулярной синхронизации используйте since вместо полного перебора.
• Чтобы узнавать о событиях сразу, а не опросом, подпишитесь на вебхуки (Вебхуки).
• Полное описание методов и схем — интерактивная документация на /api/v1/docs (доступна администраторам площадки; если нужен доступ, напишите в поддержку).