JSON-Text einrücken

Minifizierter, einzeiliger oder uneinheitlich eingerückter JSON-Text ist in Code-Reviews, Support-Tickets und Log-Dumps schwer lesbar. Dieses Werkzeug zum Pretty-Print von JSON-Text nimmt eine rohe JSON-Zeichenkette entgegen, validiert sie mit striktem Parsing und serialisiert den Wert mit konsistenter Leerzeichen-Einrückung neu, damit verschachtelte Objekte und Arrays vorhersehbar ausgerichtet sind. Ist die Nutzlast ungültig, schlägt die Aufgabe mit invalid_input fehl und meldet die Zeichenposition des Parse-Fehlers, damit Sie direkt zum falschen Komma, Anführungszeichen oder Restfragment springen können. Keine Schlüssel-Umsortierung jenseits der Standard-JSON-Serialisierung, keine Netzwerkrundreisen und keine Modell-Tokens—nur deterministisches Parse und Stringify zum veröffentlichten Basispreis $0.002 pro erfolgreichem Aufruf.

Was Pretty-Printing einer JSON-Zeichenkette tatsächlich leistet

JSON-Text hübsch zu formatieren bedeutet, eine Zeichenkette, die JSON sein will, in einen Wert zu parsen und diesen Wert mit einer festen Anzahl Leerzeichen pro Verschachtelungsebene wieder auszugeben. Diese Fähigkeit nimmt Ihr text-Feld als Quellzeichenkette, führt ein strikt JSON-Parse aus und liefert ein neues text-Feld mit konsistenter Einrückung, gesteuert durch den optionalen Parameter indent (Ganzzahl von null bis acht, Standard zwei Leerzeichen). Der Algorithmus holt keine fernen Schemas, repariert kein defektes JSON und ordnet Objektschlüssel nicht um jenseits der natürlichen Serialisierungsreihenfolge der Engine über dem geparsten Objekt. Diese Zurückhaltung hält den Vertrag einfach: gültig rein, hübsch raus; ungültig rein, klarer Fehler mit Position.

Eingabevertrag, Antwortfelder und Parse-Fehlerpositionen

Optional senden Sie indent als Ganzzahl zwischen null und acht; lassen Sie es weg, um zwei Leerzeichen zu nutzen. Schlägt das Parse fehl, enthält die Fehlermeldung immer eine Zeichenposition: Engines, die „at position N“ melden, werden mit diesem N widergespiegelt, unvollständige Eingabe wird auf das Ende der Zeichenkette abgebildet, und andere Fehler defaulten auf Position null, damit Clients stets ein Cursor-Ziel haben. Koppeln Sie diesen Endpunkt mit Editor oder Log-Viewer, indem Sie zum gemeldeten Offset springen; ein zweiter Validierungsaufruf ist nicht nötig. Senden Sie per POST einen JSON-Körper mit einer erforderlichen text-Zeichenkette, die das zu formatierende Dokument enthält. Leerer text, Nicht-String und indent außerhalb des Bereichs scheitern mit invalid_input und werden nicht abgerechnet. Bei Erfolg enthält die Antwort text (das formatierte Dokument), indent (die tatsächlich genutzte Einrückung), bytes_in (UTF-8-Länge der Quellzeichenkette) und bytes_out (UTF-8-Länge des formatierten Ergebnisses). Beispiel: text gleich einem minifizierten Objekt mit verschachtelten Arrays und indent gleich zwei liefert mehrzeiliges JSON mit Zwei-Leerzeichen-Schritten und passenden Klammern. Fehlerbeispiel: ein abgeschnittenes Objekt ohne schließende Klammer ergibt invalid_input mit Position nahe dem Ende des Fragments.

Wo Pretty-Print von JSON-Text seinen Nutzen zeigt

CI-Jobs können Konfigurationsdateien ablehnen oder umschreiben, die minifiziert von Upstream-Generatoren kommen, und schnell mit einer Parse-Position scheitern, wenn ein Release-Artefakt mitten im Upload abgeschnitten wird. Fehlgeschlagene Validierung wird nicht abgerechnet. Entwickler fügen API-Antworten in Chats und Tickets ein; Pretty-Print von JSON-Text verwandelt undurchsichtige Einzeiler in prüfbare Bäume, ohne einen Desktop-Formatierer zu installieren. Support-Tools zeigen Kunden den genauen Offset eines fehlerhaften Webhook-Körpers statt eines generischen Banners „ungültiges JSON“. Weil die Implementierung reines Parse der Stufe A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Basispreis $0.002 ohne Modell-Tokens und ohne ausgehendes Netz. Bevorzugen Sie diesen Text-ein, Text-aus-Vertrag, wenn Ihre Pipeline JSON bereits als Zeichenkette hält—Logs, Dateiinhalte, Nachrichtenkörper—statt als vorgeparstes Objekt.