Blog
Formattare e verificare JSON su Mac: dalla risposta API ai dati leggibili
Rendi leggibile una risposta compatta, individua gli errori di sintassi e copia il risultato senza inviarlo a un formattatore online.
Per esaminare una risposta JSON compatta su Mac, incolla il JSON stesso nello strumento JSON di Frset e scegli la formattazione. Usa la minificazione quando ti serve di nuovo una versione compatta. Entrambe le operazioni verificano la sintassi JSON; nessuna delle due conferma che i dati contengano i campi o i valori corretti per la tua API.
Copia il corpo della risposta, non il log che lo circonda
Un client API può mostrare insieme il testo sullo stato, le intestazioni e il corpo della risposta. Un formattatore ha bisogno della parte in JSON. Una riga come "Response received:" prima di un oggetto, o un blocco di codice copiato da un messaggio, può impedire il parsing di JSON altrimenti valido.
Tieni a disposizione la risposta originale prima di modificarla. Per esempio, {"project":"demo","enabled":true,"items":[1,2]} è un piccolo oggetto valido che puoi usare per verificare il flusso di lavoro. La formattazione rende la struttura più leggibile senza cambiarne i valori previsti.
Formatta o minifica con Frset
- Apri lo strumento di ricerca di Frset e seleziona JSON, usando la parola chiave predefinita
/jsonse non l'hai modificata. - Incolla il corpo JSON nel campo dello strumento.
- Scegli Format per aggiungere rientri leggibili oppure Minify per rimuovere gli spazi superflui.
- Avvia lo strumento ed esamina il risultato.
- Incolla il risultato copiato nell'editor, nel client API o nella nota di lavoro.
I risultati elaborati correttamente vengono aggiunti alla cronologia di Frset e copiati negli appunti di sistema. Puoi ritrovare un risultato precedente tramite il Gestore appunti, in base all'accesso e ai limiti di conservazione del tuo piano. Anche i limiti di utilizzo dello strumento dipendono dal piano.
La formattazione JSON avviene localmente e non richiede un fornitore IA né un sito di formattazione online. Lo strumento conserva l'ordine delle chiavi, la rappresentazione letterale dei numeri e il contenuto delle stringhe, cambiando solo l'impaginazione. La minificazione rimuove gli spazi di formattazione, non quelli all'interno dei valori stringa; non equivale a comprimere o cifrare un file.
Individua un errore di sintassi
Se il parsing non riesce, controlla ciò che hai copiato invece di presumere che lo strumento debba correggerlo. Tra i problemi più comuni ci sono:
- Virgole mancanti o parentesi graffe e quadre non abbinate.
- Apici singoli intorno a chiavi o stringhe, dove JSON richiede le virgolette doppie.
- Una virgola finale dopo l'ultima proprietà di un oggetto o dopo l'ultimo elemento di un array.
- Commenti, prefissi del log o una pagina di errore HTML mescolati al contenuto.
- Virgolette o interruzioni di riga non precedute da escape all'interno di una stringa.
La specifica JSON, RFC 8259, definisce il formato. Un oggetto JavaScript o un formato di configurazione che consente commenti non è necessariamente JSON valido. Correggi la sorgente con attenzione e riprova: il formattatore non può sapere quale valore mancante avevi in mente.
Distingui i dati leggibili da quelli corretti
Se la formattazione riesce, significa che l'input è stato analizzato. Non dimostra che un identificativo esista, che un timestamp usi l'unità prevista o che un campo rispetti il contratto dell'API che lo riceve. Per verificare lo schema e le regole di business dell'applicazione, usa gli strumenti di sviluppo appropriati.
Controlla anche se un valore è una stringa o un numero. Cambiare "0012" in 12 modifica i dati, anche se il risultato continua a superare il parsing. Se un campo data contiene un numero intero che non riconosci, consulta separatamente la guida alla conversione dei timestamp per verificarne l'unità e il fuso orario.
Per le attività ricorrenti, assegna un nome alle copie importanti o conserva un esempio aggiornato in una nota. Vedi come salvare frammenti di codice e configurazione. Una risposta leggibile è un punto di partenza migliore per il debug, ma restano importanti anche la richiesta originale e il comportamento dell'API.