Часті запитання

Не знайшли відповідь? Напишіть нам.

Автентифікація

Як стати партнером і отримати доступ до B2B?

Подайте заявку на busmarket.group через форму «Зв’язатися», обравши департамент продажів та маркетингу. З вами зв’яжеться менеджер відповідного регіону і допоможе завершити реєстрацію — після цього зʼявиться доступ до b2b.bm.parts. Детальніше Як стати партнером BM Parts і отримати доступ до B2B.

Як отримати API-токен?

Токен клієнт генерує самостійно в сервісі авторизації login.bm.parts/api — менеджер партнерської інтеграції для цього не потрібен. Детальніше в покроковому гайді Як отримати API-ключ.

Я отримую 401/403 — що перевірити?

Найчастіше — прострочений або відсутній токен у заголовку Authorization.

Чи є тестовий режим?

Так, для зручності є доступний тестовий режим для публічного апі. Ось інструкція як його використовувати Як перейти в тестовий режим?

API

Які ліміти на кількість запитів?

За замовчуванням — 10 000 запитів на годину на токен. Деякі ендпоінти (наприклад /prices/list) мають власний, вищий ліміт. Детальніше Ліміти на використання та квоти .

Чи можу я отримувати інформацію по розбору VIN по API?

На жаль, даий блок фунцій недоступний для клієнтів через публічне API так як діють обмеженя ліцензіної угоди.

Як отримати OE-коди товару з зазначенням бренду-виробника?

Додайте до запиту GET /product/{product_uuid} параметр oe=full — за замовчуванням (oe=short) OE-коди повертаються без бренду, а full додає й виробника для кожного коду.

Як отримати більше 30 елементів у відповіді?

Запити, які повертають велику кількість елементів, розбиваються на сторінки — по 30 елементів за замовчуванням. Наступні сторінки запитуйте параметром ?page (нумерація починається з 1), а для деяких ресурсів можна збільшити розмір сторінки до 100 елементів параметром ?per_page. Детальніше Посторінковий вивід.

Навіщо потрібен заголовок User-Agent і чому запит відхилено?

Усі запити до API повинні містити валідний заголовок User-Agent — запити без нього відхиляються з 403 Forbidden. Використовуйте код контрагента або назву свого застосунку як значення. Детальніше Обов’язковий заголовок User-Agent.

Як фільтрувати документи та звіти за періодом (датами)?

Параметр ?period приймає не довільну дату, а один із готових ключів: today, yesterday, week, month, quarter, year, all. Актуальні межі кожного періоду для конкретного функціоналу можна отримати через GET /documents/filters/dates?target=.... Детальніше Фільтрація за періодом (датами).

Загальне

Де дивитись критичні оновлення?

Усі релізи, включно зі зламними змінами, публікуються на сторінці Реліз-ноути.

Пошук

Пошук ендпоінтів, гайдів, туторіалів, реліз-ноутів по всьому порталу