Будуйте потужні інтеграції з BM Parts API
Інтерактивна OpenAPI специфікація на базі Scalar, розширені MDX-гайди, відеоінструкції та актуальний чейнжлог — усе необхідне для швидкого старту.
curl -X GET "https://api.bm.parts/shopping/carts" \
-H "Authorization: YOUR_API_TOKEN" \
-H "Accept: application/json"⚡ Швидкий старт у 3 кроки
Інтегруйте B2B API у свій проєкт за декілька хвилин
Отримайте ключ
Авторизуйтесь у кабінеті партнера та згенеруйте валідний `Bearer token` у налаштуваннях профілю.
Викликайте REST API
Робіть стандартні HTTP-запити (cURL чи будь-який інший клієнт) напряму до API — окремого SDK не потрібно.
Зробіть перший запит
Отримайте актуальні залишки складів та каталоги товарів через уніфікований REST ендпоінт.
Готова колекція запитів
Більше 200 методів API одним файлом — згенеровані напряму зі специфікації OpenAPI під час кожного білда, тож завжди відповідають поточній версії.
Документація API
Інтерактивне середовище Scalar з підтримкою OpenAPI 3.1, тестуванням запитів і генерацією коду.
Переглянути APIЩо нового?
Огляди останніх релізів, детальний розбір нових фіч та архітектурні рекомендації.
Читати блогГайди та туторіали
Детальні покрокові інструкції інтеграції, прикладні сценарії авторизації та вебхуків у форматі MDX.
Читати гайдиЧасті запитання
Не знайшли відповідь? Напишіть нам або перегляньте всі питання →
Як стати партнером і отримати доступ до B2B?
Подайте заявку на busmarket.group через форму «Зв’язатися», обравши департамент продажів та маркетингу. З вами зв’яжеться менеджер відповідного регіону і допоможе завершити реєстрацію — після цього зʼявиться доступ до b2b.bm.parts. Детальніше Як стати партнером BM Parts і отримати доступ до B2B.
Як отримати API-токен?
Токен клієнт генерує самостійно в сервісі авторизації login.bm.parts/api — менеджер партнерської інтеграції для цього не потрібен. Детальніше в покроковому гайді Як отримати API-ключ.
Які ліміти на кількість запитів?
За замовчуванням — 10 000 запитів на годину на токен.
Деякі ендпоінти (наприклад /prices/list) мають власний, вищий ліміт.
Детальніше Ліміти на використання та квоти
.
Я отримую 401/403 — що перевірити?
Найчастіше — прострочений або відсутній токен у заголовку Authorization.
- Перевірте що ви можете авторизуватись на b2b.bm.parts
- На сторінці токенів перевірте чи не закінчився термін.
- Перевірте чи передається ‘UserAgent’ Перевірте формат у гайді Як отримати API-ключ.
Як отримати більше 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=....
Детальніше Фільтрація за періодом (датами).