REST, JSON, autenticazione e casi d’uso reali: come utilizzare le Data API di FileMaker per chi deve far dialogare il gestionale con il resto del mondo.
Uno dei luoghi comuni più duri a morire su FileMaker è che sia un sistema chiuso. La realtà è l’opposto: FileMaker espone una Data API REST completa che permette a qualsiasi applicazione esterna di leggere e scrivere dati nel gestionale in modo sicuro e controllato. E-commerce, portali web, app mobile, sistemi di logistica, strumenti di automazione: tutto può dialogare con FileMaker.
In questo articolo vediamo come funziona e cosa si può costruire.
Cos’è la Data API
La FileMaker Data API è un’interfaccia REST che espone i dati di una soluzione FileMaker ospitata su FileMaker Server. Le richieste viaggiano su HTTPS e i dati sono in formato JSON — lo standard de facto per l’integrazione tra sistemi moderni.
In pratica, un sistema esterno può:
| 🔐 Autenticarsi in modo sicuro (credenziali o OAuth) | 🔍 Cercare record con criteri complessi |
| ➕ Creare nuovi record | ✏️ Aggiornare o eliminare record esistenti |
| 📎 Caricare file nei campi contenitore | ⚡ Eseguire script FileMaker lato server |
Quest’ultimo punto è più importante di quanto sembri: eseguire uno script significa poter innescare qualsiasi logica di business già presente nel gestionale come calcoli, validazioni, generazione di documenti, il tutto direttamente da un sistema esterno.
Come funziona l’autenticazione
La Data API usa un sistema di token: il client si autentica con credenziali FileMaker (o tramite OAuth con provider esterni come Microsoft Entra ID) e riceve un token di sessione valido per le richieste successive. La sessione scade dopo 15 minuti di inattività, e i permessi sono quelli dell’account FileMaker usato, con tutta la granularità del sistema di privilegi della piattaforma.
Un’integrazione esterna vede solo i dati che l’amministratore ha deciso di esporre. Un e-commerce che legge il catalogo prodotti non può toccare la contabilità. Un portale clienti che mostra lo stato degli ordini non vede i margini.
Casi d’uso reali
|
🛒
|
E-commerce sincronizzato con il gestionale Catalogo, giacenze e prezzi vivono in FileMaker; il sito li legge via Data API. Gli ordini web entrano automaticamente nel gestionale come ordini cliente. Niente doppi inserimenti, niente disallineamenti di giacenza. |
|
👤
|
Portale clienti self-service I clienti vedono ordini, fatture e stato delle spedizioni su un portale web e i dati sono letti in tempo reale dal gestionale. Il team commerciale smette di rispondere a telefonate del tipo “a che punto è il mio ordine?”. |
|
📱
|
App mobile per agenti e tecnici Un’app leggera per smartphone che legge anagrafiche e disponibilità dal gestionale e permette di inserire ordini o rapportini di intervento direttamente dal campo. |
|
🔄
|
Automazioni con Claris Connect, n8n, node-red Gli strumenti di automazione moderni parlano REST nativamente. Una mail con allegato che diventa un record, un ordine che genera una notifica su Slack, un documento firmato che aggiorna lo stato di una pratica. |
|
🤖
|
Integrazione con AI I modelli di intelligenza artificiale possono interrogare i dati del gestionale tramite Data API, o tramite la OData API che dalla versione 2026 supporta anche i webhook. È la base tecnica delle integrazioni AI nel gestionale. |
Data API o OData: quale scegliere
FileMaker Server espone due interfacce REST: la Data API e la OData API. La prima è specifica di FileMaker e dà accesso a funzionalità come l’esecuzione di script e i campi contenitore. La seconda segue lo standard OData, lo stesso usato da Microsoft e SAP, ed è ideale per integrazioni con strumenti di business intelligence come Power BI o per query complesse con sintassi standard.
| Integrazioni applicative | E-commerce, portali, app mobile → Data API |
| Analisi e BI | Power BI, query standard, ecosistema Microsoft → OData |
Cosa considerare prima di partire
Sicurezza. Le API vano esposta con certificato SSL valido, account dedicati con privilegi minimi. Per integrazioni pubbliche è consigliato esporre le API dietro un reverse proxy con rate limiting.
Architettura. La qualità dell’integrazione dipende dalla qualità della soluzione FileMaker sottostante. Layout dedicati all’API, script ottimizzati e una struttura dati pulita fanno la differenza tra un’integrazione fluida e una fonte di problemi.
Conclusione
Se la tua azienda usa FileMaker e ti è stato detto che “non si può integrare”, la risposta corretta è: si può, e probabilmente più facilmente di quanto pensi. La Data API è matura, documentata e in produzione da anni in migliaia di installazioni.
Hai un progetto di integrazione in mente?
Solinf progetta e realizza integrazioni FileMaker via Data API e OData: dall’e-commerce ai portali clienti, dalle app mobile alle automazioni con strumenti moderni. Parliamone.