«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, маркетплейси) без ручного перенесення. Це економить час і прибирає помилки ручного введення.