Referencja API

Widżet i SDK pokrywają typową ścieżkę, ale wszystko jest dostępne także jako proste HTTP API na hoście osadzenia (https://embed.scalarcut.com). Użyj go do integracji headless lub po stronie serwera.

Autoryzacja

Wywołania API autoryzują się tokenem widżetu wydanym Twojemu kontu. Przekaż go jako token Bearer:

Authorization: Bearer $WIDGET_TOKEN

Token niesie Twój id przedsiębiorstwa, id klucza widżetu i katalog, do którego jest ograniczony. Tokeny są wydawane przy ładowaniu widżetu, ważne przez siedem dni i rotowane przy każdym załadowaniu; Twój serwer pobiera świeży do wywołań po stronie serwera.

Wycena

POST /v1/tiling/estimate

Uruchamia silnik układu i zwraca pełne zestawienie materiałów dla ściany lub podłogi. Ciało to ten sam dokument układu, który buduje studio:

curl -X POST "https://embed.scalarcut.com/v1/tiling/estimate" \
  -H "Authorization: Bearer $WIDGET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "catalog": "YOUR_CATALOG_SLUG",
    "tile": { "sku": "CER-600-300" },
    "surfaces": [ { "width": 2.4, "height": 2.5, "openings": [] } ]
  }'

Gdy katalog jest zablokowany, endpoint bierze wymiary płytki ze SKU, więc żądanie nigdy nie może odbiec od rzeczywistej geometrii katalogu.

Intencja koszyka

POST /v1/tiling/cart-intent

Rozwiązuje układ w pozycje koszyka bez przeglądarki:

curl -X POST "https://embed.scalarcut.com/v1/tiling/cart-intent" \
  -H "Authorization: Bearer $WIDGET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "catalog": "YOUR_CATALOG_SLUG",
    "sku": "CER-600-300",
    "layoutFingerprint": "…",
    "quantities": { "boxes": 5 }
  }'

Odpowiedź:

{
  "lines": [
    { "sku": "CER-600-300", "qty": 5, "unit": "box" }
  ],
  "layoutFingerprint": "…",
  "layoutToken": "…"
}

Gdy materiały eksploatacyjne są włączone dla sklepu, żądanie może nieść także adhesiveKg, groutKg i primerL, a odpowiedź zyskuje odpowiadające pozycje kleju, fugi i gruntu.

SDK

GET /v1/sdk.js

Serwuje SDK osadzenia, które ładują Twoje strony. Jest stabilne wersjami i bezpieczne do cache'owania:

<script src="https://embed.scalarcut.com/v1/sdk.js"></script>

Błędy

API zwraca standardowe kody statusu HTTP z JSON-owym message:

• 401 — brak lub nieprawidłowy token.
• 403 — origin niedozwolony lub akcja wyłączona dla planu.
• 404 — nieznany katalog lub SKU.
• 422 — walidacja nie powiodła się; ciało niesie errors po polach.