JSON non valido: come trovare una virgola sbagliata e organizzare i dati

Un'integrazione non riesce e il server risponde che il JSON non è valido. Apri il contenuto e trovi parentesi graffe, parentesi quadre e decine di righe senza rientro. Prima di cercare un problema API complesso, vale la pena confermare le nozioni di base: il documento è valido JSON?

La formattazione semplifica la visualizzazione della struttura

Um Formattatore JSONriorganizza gli spazi e il rientro per mostrare dove inizia e finisce ogni oggetto. Può anche evidenziare errori di sintassi. Gli errori comuni includono virgole aggiuntive dopo l'ultimo elemento, virgolette singole invece di virgolette doppie e nomi di proprietà senza virgolette.

JSON accetta stringhe, numeri, booleani, valori null, elenchi e oggetti. La parolaVEROè diverso dalla stringa"VERO"; un'API che prevede un booleano può rifiutare il secondo. La formattazione migliora la leggibilità, ma non conferma che i nomi e i tipi siano conformi al contratto di servizio.

I messaggi di errore servono come indizi

Quando un validatore indica una riga, esamina anche quella precedente. Un delimitatore aperto sopra può causare un errore solo quando il parser incontra l'elemento successivo. Nei dati generati automaticamente, confronta la prima e l'ultima parte del file per scoprire se si è verificato un troncamento.

Non condividere mai i segreti con noncuranza

Prima di copiare JSON in ambienti esterni, rimuovere token, password e dati personali. Se il contenuto è sensibile, scegli strumenti che elaborano localmente e controlla come funzionano. Dopo aver corretto la sintassi, prova con il sistema reale: un JSON valido può ancora contenere informazioni errate.

Il bellissimo JSON può ancora essere sbagliato

Un oggetto può essere sintatticamente valido e inviare comunque la data in un formato che il servizio non accetta. Ad esempio, l'API prevede un elenco di prodotti ma riceve un singolo oggetto; il formattatore non ha modo di conoscere il contratto per questa integrazione. Dopo aver corretto il rientro, controlla la documentazione del sistema per i nomi esatti delle proprietà e quali campi sono obbligatori.

Se stai eseguendo il debug di un bug, riduci l'esempio senza cancellare il comportamento problematico. JSON più piccolo rende più semplice notare un tipo errato o una proprietà ripetuta. Non dimenticare che i caratteri di controllo, le virgolette e le barre rovesciate all'interno delle stringhe devono rispettare le regole del formato. Nei log condivisi con terze parti, sostituire credenziali e informazioni personali con valori fittizi prima dell'invio.