Blog

JSON auf dem Mac formatieren und prüfen: von der API-Antwort zu lesbaren Daten

Machen Sie eine kompakte Antwort lesbarer, untersuchen Sie Syntaxfehler und kopieren Sie das Ergebnis, ohne es an einen Online-Formatter zu senden.

Um eine kompakte JSON-Antwort auf dem Mac zu prüfen, fügen Sie nur das JSON selbst in Frsets JSON-Tool ein und wählen die Formatierung. Wenn Sie wieder eine kompakte Version benötigen, minifizieren Sie sie. Beide Vorgänge prüfen die JSON-Syntax. Keiner bestätigt, dass die Daten die für Ihre API erforderlichen Felder oder Werte enthalten.

Kopieren Sie den Antworttext ohne das umgebende Protokoll

Ein API-Client kann Statusmeldung, Header und Antworttext gemeinsam anzeigen. Ein Formatter benötigt den JSON-Teil. Eine Zeile wie „Response received:“ vor einem Objekt oder ein aus einer Nachricht kopierter Codeblock kann dazu führen, dass gültiges JSON nicht geparst werden kann.

Halten Sie die ursprüngliche Antwort bereit, bevor Sie sie bearbeiten. Zum Beispiel ist {"project":"demo","enabled":true,"items":[1,2]} ein kleines gültiges Objekt, mit dem Sie den Ablauf prüfen können. Die Formatierung macht seine Struktur leichter lesbar, ohne die beabsichtigten Werte zu ändern.

JSON mit Frset formatieren oder minifizieren

  1. Öffnen Sie die Frset-Suche und wählen Sie JSON. Verwenden Sie das Standard-Schlüsselwort /json, sofern Sie es nicht geändert haben.
  2. Fügen Sie den JSON-Antworttext in das Tool-Eingabefeld ein.
  3. Wählen Sie Format, um lesbare Einrückungen hinzuzufügen, oder Minify, um überflüssige Leerzeichen zu entfernen.
  4. Führen Sie das Tool aus und prüfen Sie das Ergebnis.
  5. Fügen Sie das kopierte Ergebnis in Ihren Editor, API-Client oder Ihre Arbeitsnotiz ein.

Erfolgreiche Ergebnisse werden dem Frset-Verlauf hinzugefügt und in die Systemzwischenablage kopiert. Über den Zwischenablage-Manager können Sie zu einem früheren Ergebnis zurückkehren, abhängig von den Zugriffs- und Aufbewahrungsregeln Ihres Tarifs. Die Tool-Limits hängen ebenfalls vom Tarif ab.

JSON-Formatierung ist ein lokaler Vorgang und erfordert weder einen KI-Anbieter noch eine Online-Formatierungswebseite. Das Tool behält die Reihenfolge der Schlüssel, Zahlenliterale und Zeichenfolgeninhalte bei und ändert nur die Darstellung. Minifizieren entfernt Formatierungsleerzeichen, aber keine Leerzeichen innerhalb von Zeichenfolgenwerten. Es ist weder Dateikomprimierung noch Verschlüsselung.

Einen Syntaxfehler untersuchen

Schlägt das Parsing fehl, prüfen Sie die kopierte Eingabe, statt anzunehmen, das Tool müsse sie reparieren. Häufige Ursachen sind:

  • Fehlende Kommas oder nicht passende geschweifte beziehungsweise eckige Klammern.
  • Einfache Anführungszeichen um Schlüssel oder Zeichenfolgen, obwohl JSON doppelte Anführungszeichen verlangt.
  • Ein Komma nach dem letzten Eintrag eines Objekts oder Elements eines Arrays.
  • Kommentare, vorangestellte Protokollmeldungen oder eine HTML-Fehlerseite in der Eingabe.
  • Nicht maskierte Anführungszeichen oder Zeilenumbrüche innerhalb einer Zeichenfolge.

Die JSON-Spezifikation, RFC 8259 definiert das Format. Ein JavaScript-Objektliteral oder ein Konfigurationsformat, das Kommentare erlaubt, ist nicht zwangsläufig gültiges JSON. Korrigieren Sie die Quelle gezielt und versuchen Sie es erneut. Der Formatter kann nicht entscheiden, welcher Wert gefehlt hat.

Lesbare von korrekten Daten unterscheiden

Erfolgreiche Formatierung bedeutet, dass sich die Eingabe parsen ließ. Sie belegt nicht, dass eine Kennung existiert, ein Zeitstempel die erwartete Einheit verwendet oder ein Feld den Vertrag der empfangenden API erfüllt. Prüfen Sie Schema und Geschäftsregeln mit den dafür vorgesehenen Entwicklungswerkzeugen.

Prüfen Sie außerdem, ob ein Wert eine Zeichenfolge oder eine Zahl ist. Wenn Sie "0012" in 12 ändern, ändern Sie die Daten, auch wenn das Ergebnis weiterhin geparst werden kann. Enthält ein Datumsfeld eine unbekannte Ganzzahl, hilft der Ratgeber zur Zeitstempelumrechnung, Einheit und Zeitzone separat zu untersuchen.

Bei wiederkehrenden Aufgaben können Sie wichtige Kopien benennen oder ein gepflegtes Beispiel in einer Notiz aufbewahren. Siehe Code- und Konfigurations-Snippets speichern. Eine lesbare Antwort ist ein besserer Ausgangspunkt für die Fehlersuche, doch die ursprüngliche Anfrage und das Verhalten der API bleiben relevant.