Ціну й наявність товарів можна отримати кількома методами — вибір залежить від того, скільки товарів потрібно за раз оновлювати.
| Метод | Товарів за раз | Актуальність | Найкраще для |
|---|---|---|---|
GET /search/products | сторінка результатів | реальний час | каталог, пошук, лістинги |
POST /search/products | багато, за відомими UUID | реальний час | масовий lookup конкретних товарів |
GET /product/{uuid} | 1 | реальний час | сторінка товару, кошик, checkout |
GET /product/{uuid}/in_stocks | 1 (лише наявність, без ціни) | реальний час | швидка перевірка залишку |
POST /prices/list | увесь каталог | на момент генерації файлу | регламентна синхронізація |
Пошук — GET /search/products
GET /search/products?q=турбіна&per_page=10&warehouses=ACF9000C2947F7AE11E28A2B02C4AD32
Ціна й in_stocks вже в кожному товарі результату. За замовчуванням
наявність — по вашому основному складу; інші склади — через warehouses.
Пошук по UUID — POST /search/products
Якщо UUID товарів вже відомі (кошик, збережений список), одним запитом
замість циклу з GET /product/{uuid}:
{ "product_uuids": ["90DFDE6FDE75833F4ECFF1B18F3EDD86", "<інший_uuid>"] }
Конкретний товар — GET /product/{uuid}
GET /product/90DFDE6FDE75833F4ECFF1B18F3EDD86?warehouses=all
Найповніша інформація по одному товару. warehouses=all — особливе
значення, доступне тільки тут: наявність одразу по всіх складах.
Тільки наявність — GET /product/{uuid}/in_stocks
Те саме, що й GET /product/{uuid}, але без ціни та інших полів — легша
відповідь, коли ціна вже відома. Ціну окремо дає GET /product/{uuid}/price.
Повний прайс — POST /prices/list
Для регламентної синхронізації всього каталогу (наприклад, раз на добу) точкові методи вище не підходять — надто багато запитів. Цей метод генерує CSV з цінами й наявністю по обраних складах для всього каталогу одразу. Деталі — «Отримання прайсу».
Типова комбінація: повна синхронізація з первною частотою(наприклад раз на добу або раз тиждень) через /prices/list + точкове
уточнення через GET /product/{uuid} перед переглядом ціни в кошику чи відвантаження.
Є ще розсилка прайсу на email — окрема інтеграція, яку вмикає лише регіональний менеджер BM Parts, не через API. Відправка прайсів відбувається 1 раз на добу.