Szybki start

Potrzebujesz klucza API z panelu: Ustawienia → Deweloper → Klucze API → Nowy klucz. Zacznij od klucza testowego.

export API=https://api.przymierz.online
export KEY=pk_test_...

1. Butik

curl -X PUT $API/v1/shops/butik-a \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"name": "Butik A"}'

2. Produkt

Podaj publiczne adresy zdjęć (JPG, PNG albo WEBP, do 8). Najlepiej ubranie na modelce przodem i jedno zdjęcie na płasko.

curl -X PUT $API/v1/garments/SKU-123 \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"name": "Sukienka midi w kratę", "shop_id": "butik-a",
       "image_urls": ["https://twoj-sklep.pl/img/sku-123-1.jpg"]}'

Przygotowanie produktu trwa chwilę w tle. Stan sprawdzisz przez GET /v1/garments/{id} albo w panelu.

3. Token klientki

Twój backend woła to po zalogowaniu klientki. external_user_id to jej identyfikator w Twoim systemie.

curl -X POST $API/v1/session-tokens \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"external_user_id": "klientka-42", "shop_id": "butik-a"}'
# {"token": "eyJ...", "token_type": "Bearer", "expires_at": "..."}

Token działa najwyżej godzinę. Przekaż go aplikacji klientki.

4. Sylwetka (z aplikacji klientki)

export TOKEN=eyJ...
# a) jednorazowy adres do wgrania zdjęcia
curl -X POST $API/v1/profiles/upload-url -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" -d '{"content_type": "image/jpeg"}'
# b) PUT pliku na upload_url z nagłówkami z odpowiedzi
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @sylwetka.jpg
# c) zapis sylwetki ze zgodami
curl -X POST $API/v1/profiles -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"key": "<key>", "consents": {"adult": true, "processing": true}}'

5. Przymiarka

curl -X POST $API/v1/tryons -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"external_product_id": "SKU-123", "priority": "browse"}'
# 202 {"id": "...", "status": "queued", ...}
curl $API/v1/tryons/<id> -H "Authorization: Bearer $TOKEN"
# {"status": "succeeded", "result_url": "https://..."}

Zamiast odpytywać, słuchaj zdarzeń. Gotowe! Teraz możesz dodać webhook i przejść na klucz produkcyjny.