Feed Studio API, версия 1

Свържете всеки магазин или система. Изпращате продуктите като JSON, а Feed Studio прави колажите и поддържа фийдовете за Meta и Google Shopping. Безплатно за всички профили.

Достъп

Създайте ключ в профила (Свързване, Отворено API) и го пращайте във всяка заявка:

Authorization: Bearer fs_YOUR_API_KEY

Базов адрес: https://webprogress.bg/studio/api/v1. Формат: JSON, UTF-8. Ограничение: 120 заявки в минута, до 1000 продукта на заявка.

Изпращане на продукти

POST /products. Режим "replace" заменя всички продукти (за първата партида на пълна синхронизация), "upsert" добавя и обновява.

curl -X POST https://webprogress.bg/studio/api/v1/products \
  -H "Authorization: Bearer fs_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "mode": "upsert",
  "sync": true,
  "products": [{
    "id": "SKU-1001",
    "title": "Stride Run 3",
    "description": "...",
    "link": "https://shop.bg/stride-run-3",
    "image_link": "https://shop.bg/img/1001-1.jpg",
    "additional_image_link": ["https://shop.bg/img/1001-2.jpg", "https://shop.bg/img/1001-3.jpg"],
    "price": 129.90,
    "sale_price": 89.90,
    "currency": "EUR",
    "brand": "STRIDE",
    "brand_logo": "https://shop.bg/brands/stride.png",
    "availability": "in stock"
  }]
}'

Отговор: {"accepted":1,"rejected":0,"errors":[],"mode":"upsert"}

Поле		Описание
`id`	*	уникален ID; трябва да съвпада с ID-то в каталога ви в Meta
`title`	*	име на продукта
`image_link`	*	главна снимка (http/https)
`price`	*	редовна цена: число или "129.90 EUR"
`sale_price`		промоционална цена; ако е по-малка от price, показваме старата зачеркната и отстъпката
`currency`		валута, по подразбиране EUR
`brand`		бранд
`brand_logo`		линк към логото на бранда (PNG с прозрачен фон е най-добре)
`additional_image_link`		масив с до 10 снимки
`description, link, availability, condition, gtin, mpn, item_group_id, product_type, google_product_category, custom_label_0..4, color, size, gender, age_group, material`		минават непроменени към фийдовете

Други заявки

`GET /status`	състояние, брой продукти и колажи, линковете към фийдовете
`GET /products?limit=100&offset=0`	изпратените продукти
`DELETE /products` `{"ids":["SKU-1001"]}`	изтрива продукти
`POST /brands` `{"brands":[{"name":"STRIDE","logo_url":"https://..."}]}`	лога на брандове отделно от продуктите
`POST /sync`	пуска рендиране веднага (иначе до 5 минути след изпращане)

Грешките са във вида {"error":{"code":"unauthorized","message":"..."}} с HTTP код 400, 401, 404, 413, 422 или 429.

Пълна синхронизация

Първата партида с "mode":"replace", следващите с "upsert", а на последната добавете "sync":true. Колажите се правят само за променените продукти, така че можете да пращате целия каталог всеки ден.

Предпочитате фийд? Подайте линк към XML или CSV в Google формат с допълнителна колона brand_logo.

Не искате да го правите сами? Поръчайте интеграция от нас.