«API интеграция» — это техническая документация, через которую сторонние программы (учётные системы, CRM, маркетплейсы) могут обмениваться данными с вашим магазином Turboshop напрямую. Страница предназначена прежде всего для разработчиков, но администратору полезно знать, что именно можно автоматизировать и где взять доступ.
Что на экране
Открывается интерактивная документация Swagger UI с заголовком «Turboshop», версией и пометкой OAS 3.0. Сверху указан адрес сервера API (например, https://demo.turboshop.ua/api) и кнопка «Authorize» для входа по ключу доступа. Ниже — поле фильтра и сгруппированные по темам ресурсы; каждую группу можно развернуть и увидеть доступные запросы (методы GET/POST/PUT/DELETE). В самом низу — блок «Schemas» со структурами данных.
Какие ресурсы доступны через API
Через API можно работать со всеми ключевыми сущностями магазина (сейчас это более 49 запросов в 16 разделах):
- Товары — полный цикл: создание и обновление карточек, цены, изображения, остатки и статусы (самый большой раздел).
- Каталоги — категории товаров и статей (структура каталога).
- Статьи — блог (новости, публикации).
- Бренды — бренды/производители.
- Покупатели — клиенты магазина.
- Заказы — создание заказов, смена статусов, получение данных.
- Поставщики — справочник поставщиков.
- Фильтры — характеристики (атрибуты) и их значения.
- Настройки — системные настройки магазина.
- Методы доставки и Методы оплаты — справочники способов доставки и оплаты.
- Магазины — торговые точки (офлайн-точки).
- Нова Пошта — данные интеграции с Новой Поштой.
- Метаданные — SEO-метаданные страниц.
- Промокоды — скидочные коды.
- Типы цен — типы цен (розница, опт, дилер).
Как это работает
Разработчик нажимает «Authorize», вводит ключ доступа, после чего может просматривать и тестировать запросы прямо в браузере. Обмен происходит в формате JSON по REST-принципам. Администратор передаёт адрес сервера и ключ специалисту, который настраивает интеграцию.
Зачем это нужно
API позволяет автоматизировать обмен товарами, ценами, остатками, заказами и клиентами между Turboshop и другими системами (1С/BAS, складской учёт, CRM, маркетплейсы) без ручного переноса. Это экономит время и убирает ошибки ручного ввода.