FAQ
Generale
Che cos'è Mockomat?
Mockomat è una piattaforma di modellazione di dominio e simulazione di API. Definisci visivamente il Tuo modello di dati, lo colleghi ai dati del pool di dati di Mockomat e lo interroghi subito tramite una mock API GraphQL live — senza scrivere codice backend. Quando il modello è pronto, puoi esportarlo come specifica OpenAPI oppure, a partire da Professional, come backend NestJS generato che Ti appartiene.
A chi è rivolto Mockomat?
- Sviluppatori frontend che hanno bisogno di un backend realistico prima che l'API reale sia pronta.
- Ingegneri full-stack che vogliono prototipare modelli di dominio e validare rapidamente il comportamento di un'API.
- Agenzie che hanno bisogno di mock API per demo e sviluppo nei progetti dei clienti.
- Architetti che vogliono validare la struttura del dominio e i contratti API prima dell'implementazione.
- Docenti che insegnano progettazione di API, GraphQL o sviluppo orientato al dominio.
- Team che hanno bisogno di una mock API condivisa per sviluppare frontend e backend in parallelo.
Mockomat è solo un mock server?
No. La mock API è un risultato, ma il valore principale è un percorso strutturato: modellazione del dominio → definizione dell'API → validazione runtime → export. La mock API serve a validare il Tuo modello, non è fine a se stessa.
Mockomat sostituisce gli strumenti di IA?
No. L'IA accelera la generazione del codice; Mockomat mantiene esplicite la struttura e le intenzioni mentre i sistemi evolvono. Usa l'IA per generare codice rapidamente e Mockomat per mantenere il modello di dominio sottostante e il contratto API coerenti, revisionabili e tracciabili.
Come si confronta Mockomat con strumenti come Postman o Stoplight?
- Postman si concentra sul test di API esistenti. Mockomat crea l'API a partire da un modello di dominio.
- Stoplight si concentra su progettazione e documentazione delle API. Mockomat aggiunge un mock runtime live con dati ed export del codice.
- Mockomat copre il percorso modello → simulazione → validazione → export. È una piattaforma di modellazione, non uno strumento di test.
Primi passi
Posso iniziare senza creare un account?
Sì. Come Guest inizi subito: ottieni un progetto nel Tuo browser per la sessione ospite di 24 ore, con un endpoint GraphQL che si apre con il token di condivisione del progetto. Le 24 ore decorrono dall'inizio della Tua sessione ospite, che l'app avvia la prima volta che la apri in questo browser: un progetto creato più tardi ha quindi meno tempo. Una pulizia eseguita ogni ora elimina poi il progetto, che può quindi restare fino a un'ora in più. Quando Ti registri, l'app offre di spostare il progetto nel Tuo account.
Qual è la differenza tra Guest e Starter?
| Guest | Starter | |
|---|---|---|
| Registrazione | Nessuna | Account richiesto |
| Progetti | 1, fino alla fine della sessione ospite di 24 ore | 1, conservato finché non lo elimini |
| Richieste API | 100 al giorno per sessione ospite, con limite per IP | 1.000 al giorno |
| Mock API dal proprio codice | Con il token di condivisione del progetto | Non incluso — le API key arrivano con Professional |
Guest serve per esplorare subito. Starter serve per il lavoro continuativo.
Quanto tempo serve per avere una mock API funzionante?
Circa 15 minuti per un modello base con alcune entità e relazioni. Vedi Primi passi per una guida passo passo.
Dati e mapping
Da dove provengono i dati mock?
Dal pool di dati di Mockomat: dataset che il nostro team importa e mantiene. Mappi ogni attributo con uno di tre tipi di mapping:
- Sorgente dati (
SOURCE) — l'attributo legge una colonna dei dati importati. È così che gli attributi ottengono i loro valori. - Costante (
CONSTANT) — un valore fisso; il runtime lo restituisce su ogni riga, sia nelle righe di dati importati sia nelle righe composte da pool di valori. - Calcolato (
COMPUTED) — un'espressione su altri campi; il runtime non valuta le espressioni, quindi un campo calcolato non fa parte della risposta. L'editor degli attributi non offre più Calcolato; un attributo che ha già un mapping calcolato lo mantiene ed è contrassegnato come non valutato.
Il pool è lo stesso su ogni piano. Non puoi caricare dataset Tuoi. Vedi Data Sources & Field Mapping (in inglese).
I dati sono realistici?
Il runtime restituisce le righe importate così come sono memorizzate e non inventa mai valori, quindi i record collegati restano coerenti tra loro. L'aspetto di un valore dipende dal dataset a cui è collegato l'attributo.
E la privacy dei dati?
Mockomat memorizza i metadati dei Tuoi progetti (definizioni del modello, mapping, configurazione). Le mock API restituiscono righe dal pool di dati, mai i Tuoi dati di produzione, quindi i Tuoi ambienti di sviluppo non hanno bisogno di dati reali dei clienti.
Posso importare uno schema esistente?
Sì. L'import OpenAPI trasforma gli schemi di un file OpenAPI 3.x o Swagger 2.0 (JSON o YAML, fino a 1 MB) in tabelle, attributi e relazioni — in un progetto nuovo o esistente, su ogni piano. Vedi Import (in inglese).
Aspetti tecnici
Quale stack tecnologico usa Mockomat?
- Backend: NestJS con GraphQL, MariaDB, MongoDB, Redis
- Frontend: Angular
- Export del codice: un servizio di generazione del codice separato che costruisce i pacchetti scaricabili
Cosa include il backend generato?
Un progetto NestJS con un'API GraphQL: un modulo per tabella con entità, resolver, service e tipi di input e output, TypeORM per MySQL / MariaDB, autenticazione JWT e un file Docker Compose per MySQL e Redis. Il pacchetto Enterprise aggiunge un frontend Angular. Vedi Export.
Il backend generato è pronto per la produzione?
Il codice generato funziona e offre query e mutation per le tabelle che hai progettato. È un punto di partenza, non un prodotto finito: aggiungi le relazioni tra le Tue tabelle, la Tua logica di business e la validazione, integra i servizi esterni, configura l'infrastruttura di produzione e scrivi i test.
Posso usare il codice generato a scopo commerciale?
Sì. Il codice generato è Tuo, senza restrizioni di licenza. Puoi modificarlo, distribuirlo, ridistribuirlo e commercializzarlo senza attribuzione né costi.
Posso eseguire il codice generato sulla mia infrastruttura?
Sì. Il backend generato è un'applicazione NestJS standard che funziona ovunque funzioni Node.js — sui Tuoi server o presso qualsiasi provider di hosting. Non serve alcun runtime o SDK di Mockomat.
Mi serve conoscere NestJS per usare Mockomat?
Non per modellare, simulare o esportare. Conoscere NestJS aiuta quando estendi il backend generato con la Tua logica di business.
Quali operazioni GraphQL supporta la mock API?
Ogni tabella riceve operazioni predefinite nell'API design. La mock API risponde alle operazioni di lettura: lista (paginata, con ordinamento e ricerca) e dettaglio (un record per ID). Puoi aggiungere parametri di filtro e, a seconda del piano, operazioni personalizzate per tabella. Il mock runtime non esegue scritture; il backend generato ha mutation per creare, aggiornare ed eliminare.
Piani e prezzi
Come funzionano i prezzi?
- Guest (gratuito) — nessun account, 1 progetto per la sessione ospite di 24 ore
- Starter (gratuito) — account richiesto, 1 progetto, 1.000 richieste al giorno
- Professional (mensile) — 10 progetti, 50.000 richieste al mese, API key, ruoli del team, export del codice
- Business (mensile) — 20 progetti, 250.000 richieste al mese, 19 membri del team, analytics degli endpoint
- Enterprise (su richiesta) — nessun limite di catalogo per progetti e richieste, 26 membri del team, limiti per contratto
I piani a pagamento sono fatturati mensilmente in euro a prezzi netti e venduti a clienti business. I prezzi attuali sono sulla pagina dei prezzi. Tutti i limiti sono in Account e piani; acquisto, cambio di piano e fatture in Billing and Invoices (in inglese).
Posso collaborare con il mio team?
- Starter: nessun membro del team, ma fino a 2 collaboratori ospiti per progetto possono partecipare alle note della board tramite un link di collaborazione.
- Professional: invita membri del team con ruoli (Solo lettura, Reporter, Editore, Gestore) — fino a 11, Te incluso.
- Business: fino a 19 membri del team, di cui 3 gestori, più gli analytics degli endpoint.
- Enterprise: fino a 26 membri del team, di cui 5 gestori, con limiti per contratto.
Vedi Team & Roles (in inglese).
Cosa succede se supero il limite di richieste?
La mock API risponde HTTP 429 (Too Many Requests) finché la quota non riparte: le quote giornaliere alle 00:00 UTC, quelle mensili il primo del mese di calendario. Contano anche le richieste dell'anteprima nell'app. Capacità aggiuntiva è disponibile su richiesta tramite il nostro team commerciale.
Come cambio piano?
Apri Account → Fatturazione e scegli il piano che desideri; si apre il portale di fatturazione che mostra il nuovo piano e il suo prezzo prima della conferma. Una disdetta ha effetto alla fine del periodo di fatturazione in corso. Solo il proprietario dell'account del workspace può cambiare piano. Vedi Billing and Invoices (in inglese).
Dove trovo le mie fatture?
Nel portale di fatturazione: Account → Fatturazione → Apri le fatture. Lì trovi anche il metodo di pagamento e i dati di fatturazione (ragione sociale, partita IVA, indirizzo). Solo il proprietario vede queste azioni.
I prezzi includono l'IVA?
No. I prezzi sono netti; l'IVA viene aggiunta al checkout in base al Tuo indirizzo di fatturazione. I piani a pagamento sono solo per clienti business, e il checkout chiede l'indirizzo di fatturazione e la partita IVA.
Come ottengo Enterprise?
Enterprise non si vende online. Usa Parla con il commerciale nell'app oppure il modulo di contatto; il prezzo è su richiesta.
Blueprint
Che cos'è un blueprint?
Un progetto Mockomat pronto all'uso per un dominio comune: Utenti & Profili, E-Commerce, Auto & Veicoli, Immobiliare, Arredamento & Casa o Cibo & Ristoranti. Cloni un blueprint nel Tuo workspace e ne adatti nomi, attributi e relazioni. Vedi Blueprint.
Posso creare i miei blueprint?
I blueprint sono pubblicati dal team di Mockomat. Per riutilizzare la Tua struttura, usa Forka un progetto per copiare uno dei Tuoi progetti in un workspace.
Risoluzione dei problemi
Per una guida diagnostica su risposte vuote, campi null, problemi di relazioni, ordinamento e parametri, ed errori di autenticazione, vedi Troubleshooting (in inglese).
Controlli rapidi
- Lista vuota? Verifica che la tabella sia collegata a dati importati — altrimenti la mock API risponde con
NOT_READY. - Le relazioni restituiscono array vuoti? Verifica la direzione della relazione e la tabella di destinazione.
- Ordinamento o filtro senza effetto?
sortFielddeve indicare un attributo collegato a una colonna di dati, e i filtri richiedono un parametro sull'operazione.
Perché alcuni screenshot risultano mancanti?
La documentazione viene costruita prima con ID degli screenshot e segnaposto, così i contenuti possono essere pubblicati mentre si preparano le acquisizioni finali. Gli screenshot mancanti vengono sostituiti appena disponibili.
Ancora visiva della pagina FAQ.