Le API di Novicrea permettono di interagire in modo programmatico con i dati della propria azienda all’interno della piattaforma. Attraverso queste API è possibile registrare vendite, recuperare ingredienti, prodotti, costi, strutture e molto altro, integrando i propri sistemi esterni (es. gestionali, ERP, app mobile) con l’ambiente di Novicrea.

Le API sono pensate per essere semplici, sicure e orientate alle operazioni quotidiane di chi lavora nel mondo della ristorazione, pasticceria e produzione alimentare.

Autenticazione

Tutti gli endpoint richiedono l’autenticazione tramite Bearer Token. Il token identifica in modo univoco l’azienda e garantisce l’accesso ai soli dati ad essa associati.

Ogni richiesta deve includere il seguente header:

Authorization: Bearer {api_token}

🔒 Se il token non è valido o è assente, la risposta sarà 403 Forbidden.

Formato delle richieste e delle risposte

• Formato richieste: application/json
• Formato risposte: tutte le risposte sono in formato JSON
• Codifica caratteri: UTF-8

Esempio di risposta positiva tipica:

{
  "success": true,
  "data": [ ... ]
}

Principali funzionalità disponibili

Con le API è possibile:

• 📈 Registrare vendite per una struttura
• 🧾 Recuperare ingredienti e fornitori
• 🍰 Gestire prodotti e analisi costi
• 🏭 Consultare strutture aziendali
• 📊 Visualizzare margini, food cost e indicatori

Ogni endpoint è descritto nei dettagli nella sezione successiva, con esempi pratici e struttura dei dati restituiti.

Versionamento

Attualmente non è previsto un versionamento esplicito tramite URL (/v1/...). Ogni modifica sarà comunicata per tempo agli sviluppatori registrati.