← Назад
referenceПочатківець⏱️ 2 хв читання

Обов'язковий заголовок User-Agent

Чому API вимагає заголовок User-Agent у кожному запиті, що передавати в ньому та як виглядає відмова 403 Forbidden без нього.

#user-agent#reference

Навіщо потрібен User-Agent

Усі запити до API повинні містити валідний заголовок User-Agent. Запити без цього заголовка будуть відхилені.

Використовуйте код свого контрагента або назву застосунку як значення заголовка — це дозволить нам зв’язатися з вами, якщо виникнуть проблеми.

Приклад:

User-Agent: Awesome-BM-Parts-App

cURL і User-Agent за замовчуванням

cURL відправляє валідний User-Agent за замовчуванням, тож якщо ви його не перевизначали — усе працює без додаткових дій. Але якщо передати порожній або невалідний заголовок User-Agent (через cURL чи інший клієнт), у відповідь прийде 403 Forbidden:

curl -i -H 'User-Agent: ' https://api.bm.parts/profile/me
HTTP/1.1 403 Forbidden
Content-Type: application/json

{
  "message": "Відсутній або невалідний заголовок User-Agent.",
  "documentation_url": "https://developer.bm.parts/api/v2/"
}

Пошук

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