In parte, e la sfumatura conta. Ogni applicazione generata espone un'API REST completa — una famiglia di rotte per tipo di dato — ma è protetta dal cookie di sessione: non esiste ancora una chiave API che consenta a un altro software di collegarsi da solo. Senza scrivere una riga, avete comunque l'esportazione in JSON e CSV di ogni insieme di dati, l'importazione di file sui dati di misura e l'accesso diretto al database se ospitate voi stessi. E poiché il codice è vostro, aggiungere una chiave API resta un lavoro ordinario.
Cosa espone davvero l'applicazione
Un'applicazione generata non è un'interfaccia posata su un database opaco: è costruita come una normale applicazione web, con un'API REST dietro le sue schermate. Per ogni tipo di dato descritto nella vostra richiesta, il motore emette la stessa famiglia di rotte: elencare e creare, poi leggere, modificare ed eliminare un record preciso. Del resto un'eliminazione non cancella nulla in via definitiva — passa dal cestino, e una rotta di ripristino esiste per annullarla.
Queste rotte non sono un extra facoltativo: sono esattamente quelle che usano le schermate dell'applicazione stessa. Non c'è quindi da un lato una «vera» API interna e dall'altro un'API pubblica impoverita: è la stessa, ed è nel codice che portate via.
Il limite da conoscere: nessuna chiave API oggi
Non appena un'applicazione richiede un accesso — il caso predefinito per i dati gestionali — le sue rotte sono protette: ogni chiamata deve portare il cookie di sessione firmato emesso all'accesso, e a un account in sola lettura viene rifiutata qualsiasi scrittura lato server, qualunque strada prenda.
Questa protezione ha una conseguenza diretta, che è meglio conoscere prima di impegnarsi: oggi non esiste né una chiave API né un token che permetta a un altro software di autenticarsi da solo, senza browser. Uno strumento terzo non può quindi interrogare l'applicazione da macchina a macchina così com'è. Preferiamo scriverlo chiaramente piuttosto che lasciare che «l'applicazione ha un'API» lasci intendere di più.
Ciò che funziona senza scrivere una riga
La schermata Impostazioni propone l'esportazione di ogni insieme di dati, in formato JSON o CSV. È la strada più breve verso un foglio di calcolo, uno strumento di reportistica o un commercialista: i dati escono quando lo decidete voi, in formati che tutti leggono.
Nell'altro senso, i dati di misura — rilevazioni, tracce, serie prodotte da un apparecchio — ricevono una rotta e un pulsante di importazione file: CSV, e GPX per le tracce. Infine, se ospitate voi stessi l'applicazione, il suo database PostgreSQL è vostro: uno strumento di reportistica può leggerlo direttamente, senza passare dall'API.
Se vi serve un'integrazione completa
Il punto da tenere è che nessuno di questi limiti è un lucchetto. L'applicazione è un normale progetto Next.js e Prisma, esportabile in ZIP o inviato al vostro repository GitHub: aggiungere un'autenticazione con chiave API a rotte che esistono già è un lavoro ben tracciato per uno sviluppatore, su codice leggibile.
È la differenza con uno strumento la cui integrazione dipende da un connettore che il fornitore offre oppure no. Qui la domanda non è mai «la piattaforma lo permetterà?» ma solo «chi lo scrive?» — e il giorno in cui lo fate, non dovete chiedere il permesso a nessuno.