🔗 Готова інтеграція з Boostore на GitHub — API-commerce скрипт
API-commerce — це готовий PHP-скрипт з відкритим вихідним кодом, який дозволяє керувати контентом вашого сайту на Boostore.pro через зручне REST API. Запустіть його за 5 хвилин на локальному комп'ютері через OpenServer або Apache та автоматизуйте роботу з товарами, статтями, візуальними блоками і сторінками сайту.
📄 Зміст статті
🚀 1. Що таке API-commerce і навіщо він потрібен
API-commerce — це PHP-скрипт з відкритим вихідним кодом, опублікований на GitHub в репозиторії BooStore-pro/API-commerce. Він виступає проміжною ланкою між вашим локальним середовищем і сайтом на Boostore.pro, надаючи зручне REST API для керування контентом.
Скрипт дозволяє виконувати практично всі операції, доступні в адмін-панелі Boostore.pro, але через HTTP-запити — це відкриває широкі можливості для автоматизації, інтеграції з CRM, складськими системами, генераторами контенту (ChatGPT, нейромережі) та будь-якими зовнішніми сервісами.
⚙ Що вміє скрипт?
📦 Товари
Створення, редагування, видалення товарів. Керування цінами, залишками, атрибутами, зображеннями, категоріями. Масовий імпорт та оновлення.
📝 Статті
Публікація статей у блог. Керування мета-тегами (title, description, keywords), категоріями блогу, мовними версіями. Повний контроль HTML-контенту.
🗄 Візуальні блоки
Створення та редагування блоків для побудови сайтів: шапки, футери, секції з товарами, банери, галереї — все, з чого збираються сторінки на Boostore.pro.
📄 Сторінки сайту
Керування сторінками: головна, каталог, контакти, про нас, лендінги. Повний контроль HTML, блоків, SEO-параметрів.
⚙ 2. Встановлення та запуск скрипта через OpenServer / Apache + PHP
Скрипт написаний на чистому PHP 7.4+ і не вимагає складного налаштування. Все, що потрібно — веб-сервер Apache з підтримкою PHP та curl. Розглянемо встановлення на прикладі OpenServer — найпопулярнішого інструменту серед веб-розробників.
👉 Покрокове встановлення на OpenServer
Завантажте репозиторій з GitHub
Перейдіть на github.com/BooStore-pro/API-commerce та завантажте архів ZIP або клонуйте репозиторій через Git:
Розмістіть скрипт у папці домену OpenServer
Розпакуйте архів у папку OpenServer/domains/api-commerce.local/ або в будь-яку іншу папку вашого локального домену.
Налаштуйте конфігурацію через веб-інтерфейс
Після першого запуску відкрийте скрипт у браузері — ви потрапите на сторінку конфігурації зі зручним GUI. Нижче — детальний опис усіх параметрів.
mod_rewrite та розширення curl.
📦 3. Які розділи доступні для керування через API на GitHub
API-commerce надає ендпоїнти для всіх ключових розділів Boostore.pro. Кожен ендпоїнт підтримує стандартні CRUD-операції (Create, Read, Update, Delete) через HTTP-методи: GET, POST, PUT, DELETE.
🗃 Повний список доступних розділів
| Розділ | Методи API | Опис |
|---|---|---|
| Статті / Блог | GET, POST, PUT, DELETE | Повне керування статтями: заголовки, HTML-контент, мета-теги, категорії блогу, мовні версії, статус публікації |
| Сторінки | GET, POST, PUT, DELETE | Керування сторінками сайту: головна, каталог, контакти, лендінги. Повний HTML-доступ, SEO-параметри, прив'язка блоків |
| Візуальні блоки (Блоки/Меню) | GET, POST, PUT, DELETE | Створення та редагування блоків для збірки сторінок: HTML-блоки, блоки товарів, меню, банери, галереї, каруселі — будь-які елементи візуального редактора Boostore.pro |
| Категорії магазину | GET, POST, PUT, DELETE | Створення та редагування категорій товарів, підкатегорій, вкладеність, сортування |
| Виробники | GET, POST, PUT, DELETE | Керування виробниками брендів: створення, редагування, прив'язка до товарів |
| Колекції | GET, POST, PUT, DELETE | Керування колекціями товарів: створення, редагування, сортування, наповнення |
| Товари | GET, POST, PUT, DELETE | Повне керування товарами: створення, редагування, ціни, залишки, атрибути, зображення, категорії |
📈 4. Гнучкість параметрів налаштування
Одна з головних переваг API-commerce — гнучка система налаштувань. Скрипт дозволяє тонко керувати процесами імпорту та експорту статей через веб-інтерфейс конфігурації. Всі параметри доступні відразу після встановлення — без редагування PHP-файлів.
📋 Загальні налаштування
Базові параметри, що визначають підключення до сайту та фільтрацію контенту:
| Параметр | Опис | Значення за замовчуванням |
|---|---|---|
| 🔑 Ключ доступу (Consumer Secret) | API-ключ для авторизації на сайті Boostore.pro. Створюється в адмін-панелі: «Налаштування → API» | — обов'язково до заповнення |
| 🌐 Адреса сайту | URL вашого сайту на Boostore.pro, наприклад https://мійсайт.boostore.pro | — обов'язково до заповнення |
| 📂 Дозволені категорії | ID категорій блогу, з якими працює скрипт. Пусто — всі категорії | всі категорії |
| 🌐 Мова еталонної статті | Статті цієї мови вважаються еталоном. При отриманні статей інших мов поля звіряються та синхронізуються з еталоном | Російська (ru) |
📥 Фільтри при імпорті (отримання статей з сайту)
Параметри, що впливають на завантаження статей з сайту в локальні HTML-файли. Дозволяють забирати тільки потрібні статті за потрібний період:
| Фільтр / Параметр | Опис | Значення за замовчуванням |
|---|---|---|
| 📥 Статей за запит (per_page) | Кількість статей, що завантажуються за 1 запит до API. Максимум 2000 | 200 |
| 📅 Дата з | Завантажувати тільки статті з датою публікації не раніше зазначеної (формат: дд.мм.рррр) | — не вказано |
| 📅 Дата по | Завантажувати тільки статті з датою публікації не пізніше зазначеної (формат: дд.мм.рррр) | — не вказано |
| 🌐 Мова | Фільтр за мовою статті. Можна вибрати конкретну мову або «всі» | всі |
| 🆔 ID > | Завантажувати тільки статті з ID більше зазначеного значення | 1000 |
| 🆔 ID < | Завантажувати тільки статті з ID менше зазначеного значення | 5000 |
| 🔍 Пошук за ім'ям (slug) | Пошук статей за частиною slug/name. Наприклад: shoes — знайде всі статті зі словом shoes в URL | — не вказано |
| 📂 Категорії для фільтрації | Список ID категорій, з яких завантажувати статті. Якщо не вибрано жодної — обробляються всі категорії. Можна вказати декілька | всі категорії |
📁 Додаткові опції структури при імпорті
- Розділяти planned в blog/planned/ — статті із запланованою датою публікації зберігаються в окрему папку
blog/planned/ - Розділяти по папках категорій — кожна категорія блогу створює свою підпапку, структура файлів повторює структуру рубрик
- Тільки з ім'ям (пропускати без name) — якщо у статті немає slug/name, вона пропускається при імпорті
🔄 Виправлення за еталоном
Після збереження статей скрипт може автоматично синхронізувати певні поля з еталонною статтею (за slug):
- multilangid — ідентифікатор багатомовної групи
- planned — дата публікації
- status — статус публікації (0/1)
- datestamp — дата створення/зміни
📤 Фільтри при експорті (відправка статей на сайт)
Параметри, що керують публікацією локальних HTML-файлів на сайті Boostore.pro:
| Параметр | Опис | Значення за замовчуванням |
|---|---|---|
| 🔄 Режим експорту | Визначає поведінку при відправці: «Додавання + оновлення» — створює нові та оновлює існуючі статті; «Тільки додавання нових» — пропускає вже існуючі; «Тільки оновлення існуючих» — не створює нові | Додавання + оновлення |
| 📦 Ліміт відправки | Скільки статей можна відправити за один запуск. Максимум 5000 | 200 |
| 📅 Режим дати публікації | Як визначати дату: з мета-даних кожної статті або примусово для всіх | З мета-даних (дата з кожної статті) |
| 📅 Перевизначити planned | Якщо задати дату — вона буде застосована до ВСІХ статей при експорті. Пусто — брати з мета-даних | — не вказано (з мета-даних) |
| 🔒 Статус доступу (status) | Режим визначення статусу публікації: з мета-даних кожної статті або примусово 0/1 для всіх | З мета-даних (статус з кожної статті) |
| 🔄 Виправлення за еталоном | Які поля автоматично виправляти за еталонною статтею при відправці: multilangid, planned, status, datestamp | multilangid, planned, status, datestamp |
📅 Параметри керування датами
API-commerce надає повний контроль над датами публікації як при імпорті, так і при експорті:
| Режим | Параметр | Як працює |
|---|---|---|
| 📥 Імпорт (фільтр) | «Дата з» / «Дата по» | Завантажувати тільки статті в діапазоні дат. Зручно для інкрементального імпорту — наприклад, забрати все за останній тиждень |
| 📥 Імпорт (структура) | «Розділяти planned» | Статті з майбутньою датою публікації зберігаються в blog/planned/, а не в основну папку. Чернетки не змішуються з опублікованим контентом |
| 📤 Експорт (режим) | «Режим дати публікації» | «З мета-даних» — кожна стаття публікується зі своєю датою. Якщо вибрати «Примусово» — всі статті отримають одну вказану дату |
| 📤 Експорт (перевизначення) | «Перевизначити planned» | Дозволяє масово виставити дату публікації для всіх статей, що відправляються. Наприклад, щоб запланувати публікацію на завтра |
| 🔄 Синхронізація | «Виправлення за еталоном: planned, datestamp» | При синхронізації багатомовних статей дати еталонної (зазвичай російської) версії копіюються в інші мови. Всі версії статті публікуються одночасно |
sitecreate_ru, опубліковані в липні 2026 року, з ID від 15000 до 16000. Виставляєте фільтри: мова = ru, категорія = 1418, дата з = 01.07.2026, дата по = 31.07.2026, ID > 15000, ID < 16000. Скрипт завантажить тільки потрібні статті — жодного сміття.
📝 5. Повний доступ до HTML-контенту
Одна з сильних сторін API-commerce — можливість передавати довільний HTML-контент практично в будь-якому полі: опис товару, тіло статті, вміст візуального блоку, контент сторінки. Жодних обмежень на теги та атрибути.
📄 Де можна використовувати HTML
📦 Товари
Повний опис товару з таблицями характеристик, списком комплектації, відеооглядами, вкладеними зображеннями — будь-який HTML в полі description.
📝 Статті
Повноцінні статті в блог: заголовки H1-H6, зображення, таблиці, списки, цитати, блоки коду, Schema.org-розмітка — все, що підтримує HTML.
🗄 Блоки
Візуальні блоки для побудови сторінок: банери, галереї, каруселі, форми, відео, анімація — будь-які HTML/CSS конструкції, що підтримуються браузером.
📄 Сторінки
Повний контроль над вмістом сторінок: головна, про нас, контакти, лендінги акцій — HTML, CSS (через inline-стилі або підключення зовнішніх файлів), JavaScript.
📝 Приклад: HTML-контент статті із зображенням та списком
На сайті цей HTML буде коректно відображений із заголовками, зображенням, списком та посиланням — як повноцінна стаття в блозі.
🔄 6. Багатомовність — керування контентом усіма мовами
Boostore.pro підтримує багатомовні сайти «з коробки». API-commerce повноцінно працює з цією функціональністю — ви можете створювати та редагувати контент будь-якою підтримуваною мовою сайту через єдиний API.
🔄 Як працює багатомовність в API-commerce
Кожен об'єкт (товар, стаття, блок, сторінка) може мати кілька мовних версій. При створенні або оновленні через API ви вказуєте параметр language — скрипт автоматично створює або оновлює відповідну мовну версію.
✅ Підтримувані мови
API-commerce підтримує всі мови, доступні у вашій установці Boostore.pro: російська (ru), українська (ua), польська (pl), англійська (en) та інші. Параметр language приймає дволітерний код мови ISO 639-1.
multilangid пов'язує різні мовні версії одного об'єкта. Це дозволяє через API-commerce керувати цілим багатомовним сайтом — створювати, оновлювати та синхронізувати контент усіма мовами в рамках одного скрипта або cron-завдання.
❓ Часті запитання про API-commerce
Відповіді на найпопулярніші питання щодо встановлення, налаштування та використання скрипта API-commerce для інтеграції з Boostore.pro.
Чи складно встановити API-commerce без досвіду програмування?
Встановлення не вимагає навичок програмування. Достатньо завантажити архів з GitHub, розпакувати в папку OpenServer та вказати API-ключі через веб-інтерфейс скрипта. Весь процес займає 5-10 хвилин. Для виконання API-запитів можна використовувати будь-який HTTP-клієнт: Postman, Insomnia, curl або готові скрипти з документації.
Чи можна запустити скрипт не на локальному ПК, а на хостингу?
Так. Скрипт працює на будь-якому хостингу з Apache + PHP 7.4+ та curl. Ви можете розмістити його на окремому піддомені або в окремій папці вашого основного домену. Однак для забезпечення безпеки рекомендується розміщувати скрипт на локальному комп'ютері або в ізольованому середовищі, а не в публічному доступі.
Які дані потрібні для підключення до Boostore.pro?
Для підключення знадобляться: URL вашого сайту на Boostore.pro та API-ключ (створюється в адмін-панелі в розділі «Налаштування → API»). Ключі можуть бути різних типів — лише для читання або з повним доступом на всі операції одним ключем.
Чи є обмеження на кількість запитів до API?
Скрипт не має вбудованих обмежень на кількість запитів. Обмеження можуть бути встановлені на рівні хостингу або тарифного плану Boostore.pro. Для масових операцій (імпорт тисяч товарів) рекомендується використовувати паузи між запитами — скрипт підтримує асинхронні черги для цього.
Чи можна використовувати API-commerce для автоматичного імпорту товарів з CRM або 1С?
Так, це один з основних сценаріїв використання. Ви можете налаштувати вивантаження з CRM/1С у форматі JSON або CSV, а скрипт API-commerce буде обробляти ці дані та створювати/оновлювати товари на сайті. Скрипт підтримує масове створення, оновлення за SKU, керування залишками та цінами. Інтеграція налаштовується через HTTP-запити з вашої CRM.
Як забезпечується безпека при роботі через API?
API-commerce використовує API-ключі для аутентифікації всіх запитів. Рекомендується розміщувати скрипт на локальному комп'ютері або в закритій підмережі, а не в публічному доступі. Всі запити до Boostore.pro виконуються через HTTPS. Для додаткової безпеки можна налаштувати IP-фільтрацію та обмежити доступ до скрипта через файл .htaccess.
Скрипт безкоштовний? Чи є приховані платежі?
API-commerce — повністю безкоштовний скрипт з відкритим вихідним кодом (MIT-ліцензія). Ви можете завантажити, встановити та використовувати його без будь-яких обмежень та прихованих платежів. Вихідний код доступний на GitHub для вивчення, модифікації та адаптації під свої завдання.
Які версії PHP підтримуються?
Скрипт працює на PHP 7.4, 8.0, 8.1, 8.2 та 8.3. Рекомендується використовувати PHP 8.1+ для максимальної продуктивності. Потрібні розширення curl та json — вони включені в стандартну поставку PHP.
Де задавати питання та повідомляти про помилки?
Всі питання, пропозиції та повідомлення про помилки приймаються через GitHub Issues репозиторію. Там же ви можете залишити свій відгук або запропонувати покращення. Розробник активно підтримує проект і відповідає на питання спільноти.