Часті запитання
Не знайшли відповідь? Напишіть нам.
Автентифікація
Як стати партнером і отримати доступ до B2B?
Подайте заявку на busmarket.group через форму «Зв’язатися», обравши департамент продажів та маркетингу. З вами зв’яжеться менеджер відповідного регіону і допоможе завершити реєстрацію — після цього зʼявиться доступ до b2b.bm.parts. Детальніше Як стати партнером BM Parts і отримати доступ до B2B.
Як отримати API-токен?
Токен клієнт генерує самостійно в сервісі авторизації login.bm.parts/api — менеджер партнерської інтеграції для цього не потрібен. Детальніше в покроковому гайді Як отримати API-ключ.
Я отримую 401/403 — що перевірити?
Найчастіше — прострочений або відсутній токен у заголовку Authorization.
- Перевірте що ви можете авторизуватись на b2b.bm.parts
- На сторінці токенів перевірте чи не закінчився термін.
- Перевірте чи передається ‘UserAgent’ Перевірте формат у гайді Як отримати API-ключ.
Чи є тестовий режим?
Так, для зручності є доступний тестовий режим для публічного апі. Ось інструкція як його використовувати Як перейти в тестовий режим?
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=....
Детальніше Фільтрація за періодом (датами).
Загальне
Де дивитись критичні оновлення?
Усі релізи, включно зі зламними змінами, публікуються на сторінці Реліз-ноути.