Riferimento API

Il widget e l'SDK coprono il percorso comune, ma tutto è disponibile anche come semplice API HTTP sull'host di incorporamento (https://embed.scalarcut.com). Usala per integrazioni headless o lato server.

Autenticazione

Le chiamate API si autenticano con un token widget emesso al tuo account. Passalo come token Bearer:

Authorization: Bearer $WIDGET_TOKEN

Il token porta il tuo id aziendale, l'id della chiave widget e il catalogo a cui è limitato. I token vengono emessi al caricamento del widget, valgono sette giorni e vengono ruotati a ogni caricamento; il tuo server ne ottiene uno nuovo per le chiamate lato server.

Preventivo

POST /v1/tiling/estimate

Esegue il motore di disposizione e restituisce la distinta materiali completa per una parete o un pavimento. Il corpo è lo stesso documento di disposizione che costruisce lo 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": [] } ]
  }'

Quando un catalogo è bloccato, l'endpoint prende le dimensioni della piastrella dallo SKU, così una richiesta non può mai divergere dalla geometria reale del catalogo.

Intento carrello

POST /v1/tiling/cart-intent

Risolve una disposizione in righe carrello senza browser:

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 }
  }'

Risposta:

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

Con i materiali di consumo abilitati per il negozio, la richiesta può portare anche adhesiveKg, groutKg e primerL, e la risposta guadagna le righe corrispondenti di colla, stucco e primer.

SDK

GET /v1/sdk.js

Serve l'SDK di incorporamento che caricano le tue pagine. È stabile per versione e sicuro da mettere in cache:

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

Errori

L'API restituisce codici di stato HTTP standard con un message JSON:

• 401 — token mancante o non valido.
• 403 — origine non consentita, o azione disabilitata per il piano.
• 404 — catalogo o SKU sconosciuto.
• 422 — validazione fallita; il corpo porta errors per campo.