Щоб робити запити до BM Parts B2B API, потрібен підписаний токен у заголовку Authorization.
Покрокова інструкція: створення нового API-ключа
0. Відкрийте login.bm.parts
Авторизуйтесь та перейдіть у розділ API-ключі login.bm.parts/api в меню ліворуч.
1. Відкрийте розділ API-ключів
На сторінці видно всі Ваші токени — з чіткою прив’язкою кожного ключа до конкретного контрагента, датою закінчення дії та хронологією створення.
2. Натисніть створення нового токена
Відкриється форма створення нового токена доступу.
3. Оберіть контрагента та підтвердіть
Вкажіть, для якого контрагента випускається токен, імʼя — і підтвердіть створення.
4. Одразу скопіюйте токен
Повне значення токена показується лише один раз одразу після створення. Скопіюйте його негайно і збережіть відповідно до рекомендацій нижче (Безпека токена) — якщо закрити вікно, не скопіювавши токен, побачити його значення повторно вже не вийде, доведеться випускати новий.
5. Перевірте, що ключ працює
Перейдіть до розділу Перевірка токена нижче і виконайте тестовий запит.
Перевірка токена
Найпростіший спосіб перевірити, що токен робочий — викликати публічний health-check без токена, а потім будь-який захищений метод з токеном:
curl -X GET "https://api.bm.parts/profile/me" \
-H "Authorization: <ВАШ_ТОКЕН>" \
-H "User-Agent: <НазваВашогоЗастосунку>/1.0"
Якщо запит повертає статускод 200 з даними профілю — токен дійсний і все працює коректно.
⚠️ Заголовок
User-Agentобов’язковий для будь-якого запиту до API — без нього можна отримати401/403навіть з дійсним токеном. Передавайте назву свого застосунку/інтеграції замість дефолтного User-Agent HTTP-клієнта.
Термін життя API-ключа(токена) - 1 рік.
Безпека токена
- Ніколи не комітьте токен у публічні репозиторії.
- Зберігайте його в змінних середовища, а не в коді.
- Періодично оновлюйте токен самостійно — створюйте новий та видаляйте старий у login.bm.parts/api.
- Якщо токен міг потрапити у треті руки — негайно видаліть його на сторінці https://login.bm.parts/api/ і створіть новий.