Vai al contenuto

Creare una mock REST API

Crea endpoint JSON finti con metodo, percorso, codice di stato, ritardo e corpo a tua scelta oppure con dati fittizi generati, serviti con CORS dal nostro server per prototipi e test.

Usa :nome per un parametro, ad es. /users/:id

Body della risposta
Ritardo0 ms

Le stringhe come "{{fullName}}" o "{{int(1, 100)}}" vengono sostituite a ogni richiesta.

elementi

0 restituisce un singolo oggetto

Segnaposto (36)
{{id}}
1, 2, 3… posizione nell'elenco
{{index}}
0, 1, 2… posizione a partire da zero
{{uuid}}
UUID v4 casuale
{{firstName}}
Nome
{{lastName}}
Cognome
{{fullName}}
Nome e cognome
{{username}}
Nome utente in minuscolo
{{email}}
Indirizzo email @example.com
{{phone}}
Numero di telefono (+1 555…)
{{company}}
Nome dell'azienda
{{jobTitle}}
Qualifica professionale
{{street}}
Indirizzo (via)
{{city}}
Città
{{country}}
Paese
{{countryCode}}
Codice ISO 3166
{{zip}}
CAP di 5 cifre
{{domain}}
dominio di esempio
{{url}}
URL https
{{ipv4}}
IPv4 per la documentazione
{{color}}
Colore HEX
{{word}}
Una parola lorem
{{words}}
words(n): n parole lorem
{{sentence}}
Frase lorem
{{paragraph}}
Da tre a cinque frasi
{{int}}
int(min, max): numero intero
{{float}}
float(min, max, decimali)
{{price}}
price(min, max): due decimali
{{bool}}
true o false
{{date}}
Data nell'ultimo anno (AAAA-MM-GG)
{{datetime}}
Data e ora ISO nell'ultimo anno
{{futureDate}}
Data nel prossimo anno
{{status}}
active, pending o inactive
{{pick}}
pick(a, b, c): una delle opzioni
{{param}}
param(nome): valore dal percorso dell'URL, ad es. :id
{{query}}
query(nome): valore dalla query string
{{null}}
null JSON
Header della risposta (facoltativi, solo X-)
Endpoint: 3 / 10 · risposte JSON con CORS attivo
Elaborato sul nostro server · l'endpoint JSON viene conservato finché non lo elimini o finché non passano 7 giorni senza richiesteCome funziona

Come usare Mock REST API

  1. 1

    Descrivi ogni endpoint

    Scegli un metodo, scrivi un percorso come /users/:id e imposta il codice di stato e, se vuoi, un ritardo per imitare una rete lenta.

  2. 2

    Scrivi la risposta

    Incolla un JSON fisso, oppure passa a Dati fittizi e scrivi un modello con segnaposto come {{fullName}} e il numero di elementi della lista.

  3. 3

    Crea la mock API

    Clicca su Crea mock API per ottenere un URL di base: ogni endpoint risponde a quell'URL più il suo percorso, con CORS attivo.

  4. 4

    Chiamala e rifinisci

    Usa Prova, curl o fetch dalla tua app, poi modifica e salva (le modifiche sono applicate subito) oppure elimina la mock quando hai finito.

Limiti e Pro

Gratis: 10 endpoint per mock API, 100 KB per body e 512 KB in totale, ritardi fino a 5 secondi, liste generate fino a 100 elementi, 120 richieste al minuto per visitatore, 10 nuove mock API all'ora, eliminazione dopo 7 giorni senza richieste.

Pro porta i limiti a 50 endpoint, body da 1 MB, ritardi di 30 secondi e liste di 1.000 elementi. Scopri Pro

Informazioni su Mock REST API

Mock REST API offre a chi sviluppa front-end e app mobile endpoint funzionanti prima che esista il vero back end. Ogni mock API ha un proprio URL di base sotto /api/mock-api/m/, e ogni endpoint che definisci risponde lì con il metodo, il percorso, il codice di stato, il ritardo, gli header e il body JSON che hai scelto. I percorsi possono contenere parametri, quindi /users/:id corrisponde a /users/7, e un modello può restituire quel valore con {{param(id)}} oppure leggere la query string con {{query(name)}}.

La modalità Dati fittizi trasforma un modello JSON in risposte realistiche grazie a 36 segnaposto: nomi, email, aziende e città, ma anche UUID, date, prezzi, numeri in un intervallo e testo lorem. Imposta il numero di elementi per ottenere un array fino a 100 elementi e decidi se i dati restano uguali tra una richiesta e l'altra, utile per gli snapshot test, oppure cambiano ogni volta. I codici di stato da 200 a 599 ti permettono di provare errori come 401, 404, 429 e 503, e un ritardo fino a cinque secondi mostra come si comportano gli stati di caricamento.

Le risposte sono sempre JSON con header CORS, quindi i browser di qualsiasi origine possono chiamarle. Una mock API non può servire HTML, impostare cookie o fare redirect, non conserva le richieste che riceve e non è un database: POST e PUT rispondono con il body che hai configurato, senza salvare nulla di ciò che viene inviato.

Privacy

Per ospitare i tuoi endpoint, le definizioni che salvi (metodi, percorsi, codici di stato, ritardi, header e body) vengono inviate e memorizzate sul nostro server, insieme a un token di modifica sotto forma di hash, agli orari di creazione e dell'ultima richiesta e al conteggio delle richieste. Alle richieste ai tuoi endpoint rispondiamo senza registrare body, header o indirizzi IP. Una mock API viene eliminata quando la elimini tu o dopo 7 giorni senza richieste né modifiche, e il token di modifica resta solo in questo browser. Chiunque abbia l'URL può chiamare i tuoi endpoint, quindi non inserirvi segreti né dati personali reali.

Funzionalità

Veri endpoint HTTPS

Qualsiasi metodo, parametri nel percorso, codici di stato da 200 a 599, ritardi e header personalizzati X-.

Modelli di dati fittizi

Oltre 30 segnaposto per persone, aziende, luoghi, date, numeri e testo, come singolo oggetto o come lista.

Sicura per progettazione

Solo JSON, CORS attivo, nessun log delle richieste, token di modifica con hash, eliminazione dopo 7 giorni senza uso.

Mock REST API: domande frequenti

Cosa viene memorizzato sul vostro server e per quanto tempo?
Memorizziamo le definizioni degli endpoint che salvi, un hash SHA-256 del tuo token di modifica, il momento di creazione e dell'ultima chiamata della mock API e il numero di richieste ricevute. Non registriamo body, header o indirizzi IP delle richieste. Ogni mock API viene eliminata quando premi Elimina, oppure in automatico dopo 7 giorni senza richieste né modifiche: se continui a usarla, resta disponibile.
Posso chiamare la mock API dalla mia app front-end?
Sì. Ogni risposta include Access-Control-Allow-Origin impostato su *, e le richieste preflight OPTIONS ricevono risposta, quindi fetch, axios o qualsiasi client HTTP del browser, su qualunque dominio (anche localhost), può chiamarla. Usa l'URL di base più il percorso dell'endpoint, ad esempio fetch(base + "/users"). Funzionano anche app mobile, Postman e curl, perché gli endpoint sono normali URL HTTPS.
Come funzionano i segnaposto dei dati fittizi?
In modalità Dati fittizi, ogni stringa del tuo modello JSON che è un segnaposto, come "{{email}}" o "{{int(1, 100)}}", viene sostituita all'arrivo di una richiesta, e i segnaposto numerici e true o false che occupano l'intera stringa diventano veri numeri e booleani JSON. I segnaposto possono stare anche dentro un testo, come "Ciao {{firstName}}". Imposta il numero di elementi per ripetere il modello, con {{id}} che conta 1, 2, 3 per ogni elemento.
Una mock può restituire errori o risposte lente?
Sì. Scegli uno stato qualsiasi da 200 a 599, come 401 Unauthorized, 404 Not Found, 422 per gli errori di validazione, 429 Too Many Requests o 503, e scrivi il JSON di errore che si aspetta la tua app. Il cursore del ritardo trattiene ogni risposta fino a 5 secondi nel piano gratuito, utile per testare spinner, timeout e logica di nuovo tentativo. Le risposte con stato 204 e 304 vengono inviate senza body.
Perché una mock API non può restituire HTML o impostare cookie?
Gli endpoint gratuiti che restituiscono qualsiasi contenuto sono molto usati per pagine di phishing e link a malware. Per rendere queste mock utili solo come API, ogni risposta è application/json con nosniff e una content security policy restrittiva, e sono ammessi solo header personalizzati che iniziano con X-: così le mock non possono impostare cookie, reindirizzare i browser o fingersi una pagina web.