Внедрение Parts-Catalogs на ваш сайт

1. Предварительные требования
2. Получение API-ключа
3. Базовая настройка
4. Дополнительные настройки
5. Установка на сайт
6. Проверка работоспособности
7. Часто задаваемые вопросы
8. Поддержка

Предварительные требования

• API-ключ для интеграции Parts-Catalogs
• Доступ к редактированию кода вашего сайта
• Базовые знания HTML/JavaScript

⚠️ Настоятельно рекомендуется привлечь к интеграции веб-разработчика, знакомого со структурой вашего сайта

Получение API-ключа

1. Свяжитесь с вашим менеджером Parts-Catalogs
2. Сообщите домен сайта, на котором будет размещен виджет
3. Получите API-ключ для интеграции

🔑 API-ключ имеет формат XXX-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX и действителен пока активен ваш тариф

Базовая настройка

1. Перейдите на страницу интеграции: https://www.parts-catalogs.com/integration/

2. В разделе "Обязательные настройки":

   • Вставьте ваш API-ключ
   • Настройте шаблон ссылки для результатов поиска

Формат шаблона ссылки

/search.html?article={article}&brand={brand}

Доступные параметры:

💡 Подробное руководство по настройке шаблона ссылки доступно в статье Как получить back-url для Parts-Catalogs

Дополнительные настройки

Языковые настройки

• Выберите язык каталога или оставьте "Автоматически"
• Поддерживаемые языки: русский, английский, немецкий

Оформление

• Выберите цветовую тему
• Настройте отображение элементов интерфейса

Ограничение доступных каталогов

По умолчанию виджет предоставляет доступ ко всем каталогам производителей. Если вы работаете только с определенными брендами, вы можете ограничить список доступных каталогов.

Для этого укажите названия брендов через запятую:

BMW, AUDI, MERCEDES-BENZ

При такой настройке:

• В виджете будут отображаться каталоги только указанных производителей
• Поиск будет осуществляться только по выбранным брендам
• Запросы к другим каталогам обрабатываться не будут

💡 Если оставить поле пустым, будут доступны все каталоги производителей

Примеры настройки:

• Только японские производители: TOYOTA, NISSAN, HONDA, MITSUBISHI
• Только немецкие бренды: BMW, AUDI, MERCEDES-BENZ, VOLKSWAGEN, PORSCHE
• Только грузовые автомобили: VOLVO TRUCKS, SCANIA, MAN, DAF

Установка на сайт

1. Скопируйте сгенерированный код
2. Вставьте код в HTML-разметку вашего сайта

Пример установки для разных CMS:

<?php
// Добавьте в header.php или через виджет
?>
<div id="parts-catalog"
  data-key="XXX-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX"
  data-back-url="/search.html?article={article}&brand={brand}"
></div>

<script type="text/javascript" src="https://gui.parts-catalogs.com/v3/parts-catalogs.js"></script>

<?require($_SERVER["DOCUMENT_ROOT"]."/bitrix/header.php");

<div id="parts-catalog"
  data-key="XXX-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX"
  data-back-url="/search.html?article={article}&brand={brand}"
></div>

<script type="text/javascript" src="https://gui.parts-catalogs.com/v3/parts-catalogs.js"></script>

<?require($_SERVER["DOCUMENT_ROOT"]."/bitrix/footer.php");?>

Проверка работоспособности

✅ Чек-лист проверки:

1. Каталог корректно отображается
2. Поиск работает
3. Результаты открываются правильно
4. Все выбранные каталоги доступны

Часто задаваемые вопросы

Поддержка

Если у вас остались вопросы или нужна консультация, наша команда поддержки всегда готова помочь. Связаться с нами →

📚 Дополнительные материалы:

• Полная документация API
• Как получить back-url для Parts-Catalogs
• Интеграция цен в Parts-Catalogs