20.2 — Documentazione API JSON simulate
Versione 2.1.1
Envelope standard
{
"schema": "VDN_API_JSON_SIMULATA",
"schema_version": "1.0",
"app_version": "2.1.1",
"ok": true,
"tipo": "...",
"data": {},
"errori": [],
"meta": {"limite_default": 50, "limite_massimo": 200},
"generated_at": "..."
}Le API sono simulate: definiscono i contratti dati locali. Il collegamento reale server/API arriverà nelle versioni successive.
Endpoint previsti
| Metodo | Endpoint | Nome | Descrizione |
|---|---|---|---|
| GET | /api/v1/health | Health check | Stato applicazione e versione DB |
| GET | /api/v1/clienti/<id_cliente> | Cliente | Anagrafica Cliente e QR |
| GET | /api/v1/clienti/<id_cliente>/punti | Punti Cliente | Saldo e ultimi movimenti Punti |
| GET | /api/v1/negozi/<id_negozio> | Negozio | Scheda Negozio sintetica |
| GET | /api/v1/negozi/<id_negozio>/credito | Credito Negozio | Saldo, soglia e stato Credito |
| GET | /api/v1/coupon | Coupon/Omaggi | Coupon attivi con filtri simulati |
| GET | /api/v1/prodotti-servizi | Prodotti/Servizi | Catalogo paginato vendibile online/offline |
| POST | /api/v1/vendite/offline | Vendita offline | Registrazione vendita offline simulata da APP Scanner/POS |
| POST | /api/v1/vendite/online | Vendita online | Registrazione ordine online simulato |
| GET | /api/v1/scambio-dati/stato | VDN_SCAMBIO_DATI | Stato cartelle e messaggi scambio dati |
| GET | /api/v1/dashboard/kpi | Dashboard KPI | KPI sintetici per Admin/Sede |