Для отримання прайсу через API використовується параметризований метод, який дозволяє:
- отримати наявність по конкретних складах;
- задати валюту;
- передати список товарів для вибірки (
products).
⚠️ Найближчим часом з’являться додаткові параметри для фільтрації товарів за виробниками авто (наприклад, BMW). Про оновлення буде повідомлено окремо в реліз-ноутах.
Ендпоінт
POST /prices/list
Параметри
| Name | Type | Description |
|---|---|---|
currency | string | валюта — UUID валюти (EUR, ГРН, USD) |
warehouses | array | масив UUID-ів необхідних складів |
products | array | масив UUID-ів необхідних товарів |
Заголовки
{
"Content-Type": "application/json",
"Authorization": "<token>",
"User-Agent": "<НазваВашогоЗастосунку>/1.0"
}
Як отримати токен — дивіться Як отримати API-ключ.
Для роботи з тестовими даними додайте заголовок X-Test-Mode — детальніше
про нього в «Як перейти в тестовий режим».
Тіло запиту
{
"currency": "<UUID валюти>",
"warehouses": ["<UUID складу>"],
"products": ["<UUID товару>"]
}
Приклад запиту
curl --request POST \
-H "Content-Type: application/json" \
-H "Authorization: <token>" \
-H "User-Agent: <НазваВашогоЗастосунку>/1.0" \
https://api.bm.parts/prices/list \
--data '{
"currency": "A358000C2947F7AE11E23F5617780B16",
"warehouses": ["81F4005056AC66D611EAD7173350C7AA"]
}'
Формат відповіді
Запит повертає дані у форматі CSV. Перший рядок — людські назви колонок,
другий — технічні (для стовпця з кількістю сюди ж закодовано короткий код і
UUID складу, до якого належить залишок: QTY:<код_складу>:<uuid_складу>).
Далі — по одному рядку на товар:
ІД,Артикул,Бренд,Назва,Ціна ГРН,Дніпро ДАГ
UUID,Article,Brand,Name,Price,QTY:DAG:81EE005056AC66D611EA758E79EBACF9
"80006E98C49AE02F4CB01012B3CA9C36","VM41023","VIBRA MASTER","Підшипник підвісний Land Rover Freelander 98-06 (d=30mm) (з підшипником FAG)","1206.96","1"
"8001FBE703F98FB947F19E8AACB88834","02.53.071","TRUCKTEC AUTOMOTIVE","Ручка дверей (передніх/задньої/ззовні) MB Sprinter/VW LT 96-","277.44","1"
"800227FC8C8B4D304502B1C1D153453F","29-16 060 0008/HD","MEYLE","Тяга стабілізатора (переднього) (L) Chevrolet Lacetti 05-","417.24","1"
"8002A089C3E7A1FC44426BF56ED29AA3","810016","FRENKIT","Направляюча супорта (переднього/к-кт) Daewoo Nubira/Chevrolet Aveo 1.2-2.0 97- (Dac)","243.72","8"
Якщо в запиті вказано декілька складів (warehouses — масив), для кожного
з них у файлі буде окрема колонка кількості зі своїм QTY:<код>:<uuid>
заголовком.
Обмеження
- Rate limit: 10 000 запитів на годину для цього ендпоінта (відрізняється від дефолтного ліміту API).
Повний і актуальний список полів запиту дивіться в інтерактивній Документації API — цей гайд описує типовий сценарій використання.