GOODVIN
+7 958 111-05-06Демо

Документация

Всё, что нужно, чтобы поставить каталог и не звонить в поддержку: параметры виджета, методы API, коды ошибок и разбор типичных сбоев.

Виджет

Параметры вставки

<div
  id="parts-catalog"
  data-key="ВАШ_КЛЮЧ"
  data-language="ru"
  data-color-schema="red"
  data-back-url="/cart"></div>
 
<script src="https://gui.parts-catalogs.com/v3/parts-catalogs.js"></script>
АтрибутЗначенияЧто делает
idparts-catalogОбязателен. Скрипт ищет контейнер строго по этому идентификатору, поэтому на странице возможен один каталог
data-keyстрокаОбязателен. Ключ привязан к домену
data-languageru, en, de, es, fr, tr, uk, ro, sk, cz, lt, et, he, arЯзык интерфейса. Можно перечислить несколько через запятую — первый подходящий станет языком каталога
data-color-schemared, yellowЦветовая схема. Без атрибута — базовая синяя
data-back-urlшаблон адресаКуда ведёт клик по детали. Подставляются {brand}, {article}, {code}, {vin}, {lang} — например ВАШСАЙТ.RU/{brand}/{article}
data-targetnew_windowОткрывать карточку детали в новой вкладке
data-price-urlадресВключает показ ваших цен: каталог запрашивает их по артикулу и бренду
data-content-modalfalseПоказывать разделы каталога в потоке страницы, а не в модальном окне
data-limit-redirectадресКуда отправить посетителя, когда исчерпан дневной лимит запросов
Про вёрстку

Зарезервируйте под каталог место заранее: задайте контейнеру min-height или aspect-ratio. Пока скрипт грузится, высота блока меняется, и без резерва страница дёрнется.

REST API

Основные методы

МетодЧто возвращаетРасходует запрос
GET /car/infoМашина по VIN или номеру кузова: catalogId, carId, criteriaДа
GET /cars/vin-validatorИсправленный номер и список опечатокНет
GET /catalogs/Марки, открытые вашему ключуНет
GET /catalogs/{id}/groups2/Уровень дерева узловНет
GET /catalogs/{id}/parts2Артикулы узла, схема и координаты выносокНет
GET /catalogs/{id}/schemasСхемы, ведущие сразу на деталиНет

Запрос расходуется только при определении новой машины. Всё, что происходит внутри найденной в течение 24 часов, бесплатно. Полный справочник из пятнадцати методов с параметрами — на странице описания API.

Ошибки

Коды и что с ними делать

КодЧто означаетЧто делать
401Ключ не передан или недействителенПроверьте заголовок Authorization: значение передаётся голым, без слова Bearer
403 / 1002Домен не авторизован для ключа виджетаДобавьте домен в настройках или напишите менеджеру. На localhost ключ виджета намеренно не работает
404Ничего не нашлось по этим параметрамПо VIN — предложите подбор по марке и модели. В parts2 обычно значит, что у узла hasParts: false
422Не передан обязательный параметрЧаще всего забыт modelId в фильтрах машин
429Превышена частота запросовПовторите через интервал из заголовка Retry-After
402Пакет исчерпанКаталог продолжает отдавать кешированные автомобили. Свяжитесь с менеджером
Диагностика

Каталог не загрузился

Частое

Можно поставить два каталога на одну страницу?

Нет. Скрипт ищет контейнер по фиксированному идентификатору, поэтому экземпляр может быть только один. Если нужно переключение между режимами, используйте API или разнесите каталоги по разным страницам.

Как добавить тестовый домен?

Напишите менеджеру список доменов, включая поддомены стенда. Ограничений по количеству нет.

Виджет мешает индексации?

Содержимое каталога отрисовывается скриптом и в индекс не попадает. Если вам нужны индексируемые страницы подбора, берите API и рендерите их на своей стороне.

Нужен ключ, чтобы попробовать

Тестовый ключ на 3 дня и sandbox для API приходят на почту.

+7 958 111-05-06