Architettura della piattaforma
Visione d'insieme
Tutte le chiamate passano dallo stesso host, https://api.e-cube.it, e richiedono un token Bearer ottenuto da /Token (Autenticazione).
Moduli dell'API
| Modulo | Scopo (dalla pagina Help ufficiale) | Pagina |
|---|---|---|
| Resource | "Use this module for CRUD operations on resources" | Resources, Query |
| Sync | "Use this api module, for bulk syncronization operation with your software" | Sync |
| Account | Gestione del token e dell'autenticazione | Account |
Risorse
Una risorsa è un insieme di dati con nome e struttura definiti, ad esempio Articoli, CliFor o StoricoDocumentiT. Ogni risorsa:
- ha una scheda nella guida campi ufficiale con nome, tipo, lunghezza, chiave, obbligatorietà e valori ammessi di ogni colonna;
- si legge con
/api/resources/{Resource}; le risorse anagrafiche e documentali si inviano con/api/sync/{Resource}; - può contenere liste annidate: le righe di un documento (
StoricoDocumentiR) viaggiano dentro la testata (StoricoDocumentiT).
Multi-tenancy
Ogni record riporta il campo customer_ID, che identifica il tenant (il cliente E-CUBE). Il tenant dipende dall'utente autenticato: non si passa come parametro. customer_ID fa sempre parte della chiave.
Campi gestiti dalla piattaforma
| Campo | Significato |
|---|---|
Id | Identificativo interno del record |
ts_update | Versione di riga (timestamp SQL, serializzato in base64) |
dat_ultvar | Data e ora dell'ultima variazione: è il riferimento della sincronizzazione incrementale |
flg_isdeleted | Cancellazione logica |
dat_sync_tsec | Data di sincronizzazione TsCloud, presente su varie risorse |
Viste MCP
Alcune risorse sono viste di sola lettura pensate per gli assistenti AI, ad esempio MCPArticoli e MCPDocumentiT. Riportano già le descrizioni e le classificazioni collegate, così l'AI non deve unire più tabelle. Il registro MCPResources elenca le risorse utilizzabili dal server MCP: vedi la sezione MCP.