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

Отримання всіх фото товарів по бренду

Як одним запитом отримати CSV-файл з посиланнями на фото всіх товарів бренду (або всього каталогу) через /lists/photos_link.

#photos#catalog#cdn#export

Якщо потрібні фото одразу для всіх товарів бренду (наприклад, для масового імпорту в свою систему), не варто ходити по товарах через GET /product/{uuid}/images в циклі — є окремий метод, який одразу віддає файл з посиланнями на всі фото.

Ендпоінт

POST /lists/photos_link

Тіло запиту

{
  "brands": ["LuK", "SOLGY"]
}

brands — опціональний масив назв брендів. Якщо не передати параметр (або тіло запиту порожнє), результат буде сформовано по всіх товарах каталогу — для одного бренду з великим асортиментом файл і так може бути чималим, а без фільтра він охоплює взагалі все.

Приклад запиту

curl --request POST \
  -H "Content-Type: application/json" \
  -H "Authorization: <token>" \
  -H "User-Agent: <НазваВашогоЗастосунку>/1.0" \
  https://api.bm.parts/lists/photos_link \
  --data '{
    "brands": ["LuK"]
  }'

Формат відповіді

Запит повертає дані у форматі CSV: ІД товару, артикул, бренд і посилання на одне фото в рядку. Якщо в товару кілька фото — на нього буде кілька рядків, по одному на кожне фото, з однаковими ІД/артикулом/брендом:

ІД, Артикул, Бренд, Посилання на фото
8000D91B0026795C4FEF5E364F54DD58, 624 3365 33, LuK, https://cdn.bm.parts/photo\r\l\r\s\l\79de296c.jpeg
8000D91B0026795C4FEF5E364F54DD58, 624 3365 33, LuK, https://cdn.bm.parts/photo\a\q\y\n\d\ee2b31f3.jpeg
8000D91B0026795C4FEF5E364F54DD58, 624 3365 33, LuK, https://cdn.bm.parts/photo\h\d\l\g\z\72dda774.jpeg
8000D91B0026795C4FEF5E364F54DD58, 624 3365 33, LuK, https://cdn.bm.parts/photo\s\z\m\o\d\3e51c626.jpeg
8000D91B0026795C4FEF5E364F54DD58, 624 3365 33, LuK, https://cdn.bm.parts/photo\g\a\b\r\r\b9c3a217.jpeg
8000D91B0026795C4FEF5E364F54DD58, 624 3365 33, LuK, https://cdn.bm.parts/photo\x\q\i\o\a\67747f96.jpeg
8000D91B0026795C4FEF5E364F54DD58, 624 3365 33, LuK, https://cdn.bm.parts/photo\h\k\i\r\k\acfdf784.jpeg
8000D91B0026795C4FEF5E364F54DD58, 624 3365 33, LuK, https://cdn.bm.parts/photo\t\f\z\n\j\5e395d8a.jpeg

Якщо групуєте фото по товару у себе в системі — групуйте рядки за ІД (UUID товару), а не за артикулом (той самий артикул теоретично може зустрічатись у різних товарів різних брендів).

Посилання на фото ще не робочі

Значення в колонці “Посилання на фото” — той самий “сирий” формат шляху, що й в інших методах з фото, з роздільниками \ замість / і без розміру зображення. Перш ніж використовувати ці посилання, приведіть кожне до робочого вигляду за кроками з туторіалу «Робота з картинками».

Пошук

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