🔗 Готовая интеграция с 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 управлять целым многоязычным сайтом — создавать, обновлять и синхронизировать контент на всех языках в рамках одного скрипта или крона.
❓ Часто задаваемые вопросы об 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 репозитория. Там же вы можете оставить свой отзыв или предложить улучшение. Разработчик активно поддерживает проект и отвечает на вопросы сообщества.