Quickstart

Ti serve solo la chiave publishable del negozio (cx_pk_live_<slug>_...), fornita dal gestore. Con quella identifichi il negozio da qualsiasi client (app mobile, script, o un frontend che non gira sul dominio del negozio).

1. Leggi il catalogo

curl "https://api.vellaro.io/api/v1/products?page=1&page_size=5" \
  -H "X-Vellaro-Key: cx_pk_live_demo_XXXXXXXXXXXXXXXX"

const res = await fetch(
  "https://api.vellaro.io/api/v1/products?page=1&page_size=5",
  { headers: { "X-Vellaro-Key": "cx_pk_live_demo_XXXXXXXXXXXXXXXX" } }
);
const { data, meta } = await res.json();
console.log(data, meta); // data = prodotti, meta = paginazione

import httpx
r = httpx.get(
    "https://api.vellaro.io/api/v1/products",
    params={"page": 1, "page_size": 5},
    headers={"X-Vellaro-Key": "cx_pk_live_demo_XXXXXXXXXXXXXXXX"},
)
print(r.json()["data"])

Se il tuo client gira sul dominio del negozio (es. https://mionegozio.com), le chiamate sono same-origin verso https://mionegozio.com/api/v1 e la chiave non serve: l’infrastruttura riconosce il negozio dal dominio.

2. La busta delle risposte

Ogni risposta ha lo stesso involucro:

{
  "data": [ /* payload */ ],
  "meta": { "page": 1, "page_size": 5, "total": 42, "total_pages": 9 },
  "error": null,
  "error_code": null
}

data — il contenuto (null in caso di errore).
meta — presente sulle liste paginate.
error_code — codice macchina stabile (es. auth.invalid_credentials): fai switch su questo per mostrare messaggi localizzati, non su error (che è solo per debug).

3. Cosa esplorare dopo

Autenticazione

Chiave publishable, login cliente, token staff.

Concetti

Negozio, envelope, errori, paginazione, i18n, immagini.

Carrello & checkout

Dal carrello all’ordine pagato.

API Reference

Riferimento completo, sempre in sync con la produzione.

Inizia

Guide

AI & MCP

1. Leggi il catalogo

2. La busta delle risposte

3. Cosa esplorare dopo

Autenticazione

Concetti

Carrello & checkout

API Reference

​1. Leggi il catalogo

​2. La busta delle risposte

​3. Cosa esplorare dopo

Autenticazione

Concetti

Carrello & checkout

API Reference

1. Leggi il catalogo

2. La busta delle risposte

3. Cosa esplorare dopo