Butiki i produkty

Butiki

PUT /v1/shops/{external_id} zakłada albo aktualizuje butik.

{ "name": "Butik A", "enabled": true }

GET /v1/shops zwraca wszystkie butiki firmy.

enabled: false wyłącza przymierzalnię w butiku. Przymiarki zwracają wtedy 403 shop_disabled. Butiki możesz też dodawać i włączać w panelu.

Produkty

PUT /v1/garments/{external_id}:

Pole	Opis
name	Nazwa produktu (do 300 znaków)
description	Opis ze sklepu, pomaga AI (opcjonalnie)
shop_id	external_id butiku
image_urls	1 do 8 publicznych adresów zdjęć

Cały katalog naraz: POST /v1/garments:batch z polem items (do 100 produktów).

Najlepiej przekazać produkty przed live’em: przygotowanie dzieje się w tle i pierwsza przymiarka jest wtedy szybsza. Produkt nieznany w chwili przymiarki możesz też przekazać w polu product przy POST /v1/tryons.

Karta produktu

Ze zdjęć i opisu powstaje karta, z której budujemy polecenie dla modelu AI:

{
  "garment_type": "dress",
  "tryon_items": [{ "piece": "sukienka", "category": "dress" }],
  "length": "midi",
  "sleeves": "long",
  "fit": "regular",
  "key_details": ["krata", "wiązanie w talii"],
  "best_photo": 0
}

Stan produktu	Znaczenie
pending	Przygotowuję zdjęcia i kartę
ready	Gotowy do przymiarek
needs_review	AI nie jest pewne części cech, sprawdź kartę w panelu
manual	Karta zatwierdzona albo poprawiona przez butik
failed	Nie udało się pobrać zdjęć (error mówi dlaczego)

Kartę poprawisz w panelu (Produkty → produkt) albo przez PUT /v1/garments/{id}/card. Ręczna karta ma pierwszeństwo przed AI.