API Mock from Spec
Genera risposte mock da una specifica OpenAPI - paste la spec e ottieni dati di test.
OpenAPI JSON Spec
Endpoint Mock
Come utilizzare API Mock from OpenAPI Spec
Incolla la specifica OpenAPI 3.0 in formato JSON
Copia il contenuto del file openapi.json (o swagger.json) della tua API e incollalo nell'area di testo. La specifica deve essere in formato JSON valido e seguire lo standard OpenAPI 3.0 con la sezione "paths" presente.
Analizza gli endpoint rilevati
Dopo il parsing, lo strumento mostra tutti gli endpoint della specifica con metodo HTTP, path e descrizione. Ogni endpoint ha un mock della risposta generato automaticamente in base agli schema definiti nella spec.
Copia i mock JSON per i test
Per ogni endpoint, clicca il pulsante "Copia" per copiare il JSON mock negli appunti. Usa il mock come risposta simulata nei tuoi test unitari, nel tuo server di sviluppo locale o nelle collection Postman/Insomnia.
Suggerimenti
- Se la tua specifica usa la sezione "$ref" per i componenti riusabili, assicurati che tutti i riferimenti siano inline nella specifica (o risolti) prima di incollarla. Riferimenti a file esterni non vengono risolti.
- Usa i mock generati come fixture nei test Jest o Vitest: importa il JSON come costante nel test e usalo come valore di ritorno del mock del servizio HTTP per test deterministici e veloci.
- Strumenti come Prism (Stoplight) o MSW (Mock Service Worker) possono usare direttamente la tua spec OpenAPI per creare un mock server completo: ideali per sviluppo locale quando il backend non e' ancora disponibile.
Domande frequenti
Cosa si intende per mock response in un'API?
Una mock response e' un dato JSON simulato che rappresenta come sarebbe la risposta reale dell'API senza chiamare effettivamente il server. E' utile per testare il frontend in isolamento, sviluppare funzionalita' prima che il backend sia pronto, e scrivere test unitari deterministici.
Lo strumento supporta OpenAPI 2.0 (Swagger)?
Lo strumento e' ottimizzato per OpenAPI 3.0. Le spec OpenAPI 2.0 (Swagger) hanno una struttura diversa e potrebbero non essere parsate correttamente. Per usarlo con una spec 2.0, converti prima la specifica al formato 3.0 usando un tool come swagger2openapi o il convertitore online di Swagger Editor.
Come vengono generati i valori nei mock?
I valori vengono generati in modo deterministico dalla definizione degli schema nella spec: stringhe, numeri, booleani e array vengono popolati con valori di esempio plausibili in base al tipo e ai constraint (minLength, minimum, enum, ecc.). I valori sono statici, non casuali, per garantire la riproducibilita' dei test.
I dati vengono inviati a un server?
No, l'intero processo avviene nel browser (client-side). La specifica OpenAPI incollata non viene trasmessa a nessun server. Il parsing e la generazione dei mock avvengono tramite JavaScript nel tuo browser.