Sir William Stock API · Fase 1

Base URL: /api/v1. Tutti gli endpoint, escluso /health, richiedono Authorization: Bearer API_KEY.

Apri la specifica OpenAPI JSON

Lettura

GET /api/v1/health

Stato pubblico del servizio.

GET /api/v1/inventory?warehouse=bar&search=guinness&low_stock=true&page=1&limit=100

Inventario filtrabile e paginato.

GET /api/v1/kegs

Numero fusti, capacità e litri disponibili.

GET /api/v1/kegs/low-stock

Solamente i fusti da ordinare.

GET /api/v1/assistant/summary

Riepilogo compatto per un assistente esterno.

Importazione protetta

POST /api/v1/import/invoice/preview

Valida, controlla duplicati e riconosce i prodotti. Non modifica nulla.

POST /api/v1/import/invoice/confirm

Accetta {"preview_id":"..."}. Funziona soltanto se tutti i prodotti sono riconosciuti e crea un backup prima del carico.

Esempio

curl https://sir-william-stock.pages.dev/api/v1/inventory \
  -H "Authorization: Bearer LA_TUA_API_KEY"

Le chiavi non sono contenute nell'app o in questa documentazione: vanno salvate come Secrets Cloudflare.