Developer Hub v3.0

Будуйте потужні інтеграції з BM Parts API

Інтерактивна OpenAPI специфікація на базі Scalar, розширені MDX-гайди, відеоінструкції та актуальний чейнжлог — усе необхідне для швидкого старту.

0+ методів APIOpenAPI 3.1 специфікація Статус систем
cURLGET /shopping/carts
curl -X GET "https://api.bm.parts/shopping/carts" \
  -H "Authorization: YOUR_API_TOKEN" \
  -H "Accept: application/json"

⚡ Швидкий старт у 3 кроки

Інтегруйте B2B API у свій проєкт за декілька хвилин

1

Отримайте ключ

Авторизуйтесь у кабінеті партнера та згенеруйте валідний `Bearer token` у налаштуваннях профілю.

2

Викликайте REST API

Робіть стандартні HTTP-запити (cURL чи будь-який інший клієнт) напряму до API — окремого SDK не потрібно.

3

Зробіть перший запит

Отримайте актуальні залишки складів та каталоги товарів через уніфікований REST ендпоінт.

Postman

Готова колекція запитів

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

Завантажити .json

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

Не знайшли відповідь? Напишіть нам або перегляньте всі питання →

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

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

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

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

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

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

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

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

Як отримати більше 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=.... Детальніше Фільтрація за періодом (датами).

Пошук

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