Protobuf zu JSON Schema

Der Protobuf-zu-JSON-Schema-Konverter ist ein kostenloses Online-Tool, das proto3-Definitionen in JSON Schema, TypeScript-Interfaces und Beispiel-JSON umwandelt. Es unterstützt Messages, Enums, verschachtelte Typen, oneof, map und repeated. Es läuft vollständig in deinem Browser, ohne Installation oder Anmeldung.

Proto3: Messages, Enums, verschachtelte Messages, repeated, optional, oneof, map-Felder und alle skalaren Typen.

Drei: JSON Schema (Draft-07 mit $ref), TypeScript-Interfaces und Beispiel-JSON mit Platzhalterwerten.

Sie werden sowohl in JSON Schema als auch in TypeScript auf string abgebildet, gemäß der standardmäßigen Protobuf-JSON-Mapping-Konvention für 64-Bit-Ganzzahlen.

Ja, der Protobuf-zu-JSON-Schema-Konverter ist zu 100 % kostenlos, ohne Registrierung, ohne versteckte Gebühren und ohne Nutzungslimits. Die gesamte Verarbeitung erfolgt lokal in deinem Browser und gewährleistet vollständige Privatsphäre.

Absolut. Der Protobuf-zu-JSON-Schema-Konverter verarbeitet alles clientseitig in deinem Browser. Es werden keine Daten auf einen Server hochgeladen oder dort gespeichert. Deine Inhalte bleiben jederzeit privat auf deinem Gerät.

Ja, der Protobuf-zu-JSON-Schema-Konverter ist vollständig responsiv und funktioniert auf Smartphones und Tablets. Du kannst ihn auf jedem Gerät mit einem modernen Webbrowser nutzen, ohne App-Download.

Es ist kein Konto und keine Registrierung erforderlich. Öffne einfach den Protobuf-zu-JSON-Schema-Konverter in deinem Browser und beginne sofort mit der Nutzung. Es gibt keine Anmeldeschranken oder Nutzungsbeschränkungen.

Der Protobuf-zu-JSON-Schema-Konverter unterstützt eine breite Palette beliebter Formate und Sprachen. In der Benutzeroberfläche des Tools findest du die vollständige Liste der unterstützten Optionen.

Gib einfach deine Eingabe in das vorgesehene Feld ein, passe die Einstellungen nach Wunsch an, und das Tool verarbeitet sie sofort. Anschließend kannst du das Ergebnis in die Zwischenablage kopieren oder herunterladen.

Eine .proto-Datei ist die Quelldefinition für Protocol Buffers: Sie deklariert Messages, Felder, Typen und Feldnummern, die zur Serialisierung kompakter Binärdaten für gRPC und durchsatzstarke APIs verwendet werden. Ein JSON Schema beschreibt die Form eines JSON-Dokuments, damit Validatoren prüfen können, ob eingehende oder ausgehende Payloads die richtigen Felder und Typen haben. Beide verfolgen dieselbe Idee -- einen Datenvertrag -- aber in unterschiedlichen Welten: Protobuf regelt das binäre Wire-Format, während JSON Schema das menschenlesbare JSON regelt, das in Web-APIs, Konfigurationen und Dokumentation verwendet wird. Wandelt man das eine in das andere um, lässt sich JSON gegen dieselbe Struktur validieren, die deine Services bereits binär durchsetzen. Dieses Tool liest eine proto3-Definition und erzeugt ein JSON Schema nach Draft-07, mit $ref-Verweisen in einen gemeinsamen definitions-Block, sodass du es direkt in einen Validator einbinden kannst, ohne Feldnamen von Hand neu zu schreiben.

64-Bit-Integer-Typen -- int64, uint64, sint64, fixed64 und sfixed64 -- werden sowohl im JSON Schema als auch im Beispiel-JSON als Strings dargestellt, nicht als Zahlen. Das ist keine Eigenheit des Konverters, sondern folgt der offiziellen Protobuf-JSON-Zuordnung. JavaScripts number-Typ ist eine Gleitkommazahl mit doppelter Genauigkeit, die Integer nur bis 2^53 sicher darstellen kann, sodass ein echter 64-Bit-Wert bei der Interpretation als Zahl stillschweigend an Präzision verlieren könnte. Die Kodierung als String bewahrt jede Ziffer und lässt sich verlustfrei über Sprachgrenzen hinweg hin- und zurückkonvertieren. 32-Bit-Integer wie int32 und uint32 bleiben einfache Zahlen, da sie problemlos hineinpassen. Dieses Wissen verhindert Überraschungen bei der Validierung, wenn ein Backend eine große ID oder einen Zeitstempel sendet. Füge dein Schema hier ein, und das Tool wendet die String-versus-Zahl-Regel automatisch auf jedes numerische Feld an.

Jedes Protobuf-Konstrukt wird auf sein natürliches JSON-Äquivalent abgebildet. Ein repeated-Feld wird zu einem JSON-Array und einem TypeScript-Array-Typ, da es null oder mehr Werte enthalten kann. Ein map<key, value>-Feld wird als JSON-Objekt mit additionalProperties zur Typisierung der Werte dargestellt, weil Protobuf-Maps Schlüssel-Wert-Sammlungen sind. Ein oneof-Block gibt jedes Mitgliedsfeld aus, und das JSON Schema hält fest, dass sich die Optionen gegenseitig ausschließen, sodass immer nur eine gesetzt sein kann. Optionale Felder werden im Schema nicht mehr verpflichtend und erhalten im TypeScript-Interface ein ?, während skalare und verschachtelte Message-Typen über $ref-Verweise aufgelöst werden. Dadurch werden komplexe, reale Schemas originalgetreu übersetzt, statt abgeflacht oder verworfen zu werden. Klicke auf Sample .proto, um ein Beispiel mit einem repeated-Feld, einer map und einem oneof zu laden, und vergleiche dann die Tabs, um genau zu sehen, wie jedes behandelt wird.

Der Sample-JSON-Tab erstellt ein vollständiges Beispielobjekt, indem jedes Feld mit einem repräsentativen Platzhalter befüllt wird, damit du die Struktur der Message sofort erkennst. Ein string wird zu "example", ein double zu 3.14, Integer-Felder erhalten Platzhalterzahlen, und ein bytes-Feld zeigt einen kurzen base64-kodierten String wie "dGVzdA==", da bytes in JSON als base64-Strings typisiert werden. repeated-Felder erscheinen als Arrays, maps als Objekte, und verschachtelte Messages werden inline ausgeklappt. Das sind keine echten Daten -- es sind typisierte Platzhalter, die dazu gedacht sind, eine Fixture, einen Postman-Request-Body oder eine Mock-API-Antwort zu befüllen, ohne ein realistisches Payload von Hand einzutippen. Da die Werte zum jeweiligen Feldtyp passen, besteht das Beispiel die Validierung gegen das JSON Schema, das das Tool aus demselben proto erzeugt. Füge dein Schema ein und öffne den Sample-JSON-Tab, um ein bearbeitungsfertiges Beispiel zu kopieren oder herunterzuladen.

Ja. Neben dem JSON Schema erzeugt der Konverter einsatzbereites TypeScript: ein interface pro Message und ein echtes enum pro Protobuf-Enum, sodass die Ausgabe direkt in ein Projekt übernommen werden kann und Typüberprüfung zur Kompilierzeit liefert. Die Feldtypen folgen der Protobuf-JSON-Zuordnung -- Strings, Zahlen, Booleans, Arrays für repeated-Felder und ?-Markierungen bei optionalen Feldern. 64-Bit-Integer werden als string typisiert, um Präzisionsverluste zu vermeiden, und bytes-Felder werden als base64-Strings typisiert. Inline-Kommentare in deiner .proto werden als Beschreibungen übernommen, sodass die generierten Typen dokumentiert bleiben. Das hält ein Frontend mit der Source of Truth des Backends synchron, ohne Feldnamen bei jeder Schemaänderung von Hand abzutippen -- genau dort schleichen sich sonst Tippfehler und Abweichungen ein. Füge deine proto3-Definition ein, wechsle zum TypeScript-Tab und kopiere das Ergebnis oder lade es als types.ts herunter.