← Назад
getting-startedПочатківець⏱️ 4 хв читання

Як отримати API-ключ

Звідки взяти підписаний токен для роботи з BM Parts B2B API — і покрокова інструкція зі скріншотами, як створити новий ключ у сервісі авторизації.

#auth#api-key

Щоб робити запити до BM Parts B2B API, потрібен підписаний токен у заголовку Authorization.

Покрокова інструкція: створення нового API-ключа

0. Відкрийте login.bm.parts

Авторизуйтесь та перейдіть у розділ API-ключі login.bm.parts/api в меню ліворуч.

1. Відкрийте розділ API-ключів

На сторінці видно всі Ваші токени — з чіткою прив’язкою кожного ключа до конкретного контрагента, датою закінчення дії та хронологією створення.

Список API-ключів у сервісі авторизації

2. Натисніть створення нового токена

Відкриється форма створення нового токена доступу.

Форма створення нового API-токена

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 рік.

Безпека токена

  1. Ніколи не комітьте токен у публічні репозиторії.
  2. Зберігайте його в змінних середовища, а не в коді.
  3. Періодично оновлюйте токен самостійно — створюйте новий та видаляйте старий у login.bm.parts/api.
  4. Якщо токен міг потрапити у треті руки — негайно видаліть його на сторінці https://login.bm.parts/api/ і створіть новий.

Пошук

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