> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vellaro.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Vellaro API

> Il motore e-commerce API-first. Costruisci storefront, app mobile e automazioni AI su Vellaro.

Vellaro è un **motore e-commerce headless**: usi le nostre API come backend e
costruisci liberamente il tuo storefront, la tua app mobile o le tue integrazioni.
Catalogo, ricerca, carrello, checkout, pagamenti, ordini, account, contenuti — tutto
è esposto via REST, con la stessa infrastruttura che alimenta gli storefront ufficiali.

<CardGroup cols={2}>
  <Card title="Costruisci uno storefront" icon="store" href="/guides/build-storefront">
    Web frontend completo con la Storefront API (chiave publishable).
  </Card>

  <Card title="Costruisci un'app mobile" icon="mobile" href="/guides/build-mobile">
    iOS/Android/Flutter sulla stessa API, con la chiave publishable.
  </Card>

  <Card title="Gestisci il negozio via API" icon="gear" href="/guides/admin-api">
    Catalogo, ordini, clienti e altro con la Admin API (token staff).
  </Card>

  <Card title="AI & MCP" icon="robot" href="/ai-mcp">
    Collega Vellaro ai motori AI come connettore (MCP) — commerce conversazionale.
  </Card>
</CardGroup>

## Due superfici API

| Superficie     | Per chi                                   | Auth                                                           | Prefisso             |
| -------------- | ----------------------------------------- | -------------------------------------------------------------- | -------------------- |
| **Storefront** | frontend/mobile (lato cliente)            | chiave publishable `cx_pk_...` (+ token cliente per l'account) | `/api/v1/*` pubblici |
| **Admin**      | gestione del negozio, integrazioni ERP/AI | token staff (JWT) con permessi                                 | `/api/v1/admin/*`    |

La chiave publishable **non** può toccare gli endpoint `/admin/*`: anche se trapelasse,
resta limitata ai dati storefront del negozio.

## Passi successivi

<Steps>
  <Step title="Ottieni una chiave">
    Il gestore del negozio ti fornisce la **chiave publishable** (`cx_pk_live_...`).
    Per la Admin API serve un **account staff** con i permessi adeguati.
  </Step>

  <Step title="Prima chiamata">
    Segui il [Quickstart](/quickstart) e leggi il catalogo in 30 secondi.
  </Step>

  <Step title="Costruisci">
    Scegli una [guida](/guides/build-storefront) e usa la
    [API Reference](/api-reference) generata dallo schema OpenAPI live.
  </Step>
</Steps>