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

  1. Apri lo strumento di ricerca di Frset e seleziona JSON, usando la parola chiave predefinita /json se non l'hai modificata.
  2. Incolla il corpo JSON nel campo dello strumento.
  3. Scegli Format per aggiungere rientri leggibili oppure Minify per rimuovere gli spazi superflui.
  4. Avvia lo strumento ed esamina il risultato.
  5. 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.