Protobuf vers JSON Schema

Le convertisseur Protobuf vers JSON Schema est un outil en ligne gratuit qui convertit des définitions proto3 en JSON Schema, en interfaces TypeScript et en JSON d'exemple. Il prend en charge les messages, les enums, les types imbriqués, oneof, map et repeated. Il fonctionne entièrement dans votre navigateur, sans installation ni inscription.

Proto3 : messages, enums, messages imbriqués, repeated, optional, oneof, champs map et tous les types scalaires.

Trois : JSON Schema (Draft-07 avec $ref), interfaces TypeScript et JSON d'exemple avec des valeurs d'espace réservé.

Ils sont convertis en string à la fois en JSON Schema et en TypeScript, conformément à la convention standard de mappage JSON de protobuf pour les entiers 64 bits.

Oui, le convertisseur Protobuf vers JSON Schema est 100 % gratuit, sans inscription, sans frais cachés et sans limite d'utilisation. Tout le traitement s'effectue localement dans votre navigateur, garantissant une confidentialité totale.

Absolument. Le convertisseur Protobuf vers JSON Schema traite tout côté client, dans votre navigateur. Aucune donnée n'est envoyée ni stockée sur un serveur. Votre contenu reste à tout moment privé sur votre appareil.

Oui, le convertisseur Protobuf vers JSON Schema est entièrement responsive et fonctionne sur smartphones et tablettes. Vous pouvez l'utiliser sur tout appareil doté d'un navigateur web moderne, sans télécharger d'application.

Aucun compte ni inscription n'est nécessaire. Ouvrez simplement le convertisseur Protobuf vers JSON Schema dans votre navigateur et commencez à l'utiliser immédiatement. Il n'y a ni barrière d'inscription ni restriction d'utilisation.

Le convertisseur Protobuf vers JSON Schema prend en charge un large éventail de formats et de langages populaires. Consultez l'interface de l'outil pour voir la liste complète des options prises en charge.

Saisissez simplement votre entrée dans le champ prévu, ajustez les réglages selon vos préférences et l'outil la traitera instantanément. Vous pouvez ensuite copier le résultat dans votre presse-papiers ou le télécharger.

Un fichier .proto est la définition source de Protocol Buffers : il déclare les messages, les champs, les types et les numéros de champ utilisés pour sérialiser des données binaires compactes pour gRPC et les API à fort débit. Un JSON Schema décrit la forme d'un document JSON afin que des validateurs puissent vérifier que les payloads entrants ou sortants ont les bons champs et les bons types. Les deux servent la même idée -- un contrat de données -- mais dans deux mondes différents : protobuf régit le format binaire sur le réseau, tandis que JSON Schema régit le JSON lisible par un humain utilisé dans les API web, les fichiers de configuration et la documentation. Convertir l'un vers l'autre permet de valider du JSON selon la même structure que vos services appliquent déjà en binaire. Cet outil lit une définition proto3 et produit un JSON Schema conforme à Draft-07, en utilisant des pointeurs $ref vers un bloc definitions partagé, pour que vous puissiez l'injecter directement dans un validateur sans réécrire les noms de champs à la main.

Les types entiers 64 bits -- int64, uint64, sint64, fixed64 et sfixed64 -- sont représentés sous forme de chaînes de caractères plutôt que de nombres, aussi bien dans le JSON Schema que dans le JSON d'exemple. Ce n'est pas une bizarrerie du convertisseur : cela suit le mappage JSON officiel de Protobuf. Le type number de JavaScript est un flottant double précision qui ne peut représenter de façon sûre que les entiers jusqu'à 2^53, si bien qu'une véritable valeur 64 bits pourrait silencieusement perdre en précision si elle était interprétée comme un nombre. L'encoder en chaîne préserve chaque chiffre et permet un aller-retour fiable entre langages. Les entiers 32 bits comme int32 et uint32 restent de simples nombres, car ils entrent sans problème dans cette plage. Connaître cette règle évite de mauvaises surprises de validation lorsqu'un backend envoie un identifiant ou un timestamp de grande taille. Collez votre schéma ici et l'outil applique automatiquement la règle chaîne contre nombre pour chaque champ numérique.

Chaque construction protobuf est convertie vers son équivalent JSON naturel. Un champ repeated devient un tableau JSON et un type tableau en TypeScript, puisqu'il contient zéro ou plusieurs valeurs. Un champ map<key, value> est rendu sous forme d'objet JSON utilisant additionalProperties pour typer les valeurs, car les maps protobuf sont des collections clé-valeur. Un bloc oneof génère chacun de ses membres, et le JSON Schema consigne le fait que les options sont mutuellement exclusives, si bien qu'une seule peut être définie à la fois. Les champs optional deviennent non obligatoires dans le schéma et gagnent un ? dans l'interface TypeScript, tandis que les types scalaires et les messages imbriqués se résolvent via des pointeurs $ref. Ainsi, des schémas complexes du monde réel sont traduits fidèlement plutôt qu'aplatis ou perdus. Cliquez sur Sample .proto pour charger un exemple qui inclut un champ repeated, une map et un oneof, puis comparez les onglets pour voir précisément comment chacun est traité.

L'onglet JSON d'exemple construit un objet complet en remplissant chaque champ avec une valeur type représentative, pour que vous puissiez voir immédiatement la forme du message. Un string devient "example", un double devient 3.14, les champs entiers reçoivent des nombres de substitution, et un champ bytes affiche une courte chaîne encodée en base64 comme "dGVzdA==", car les bytes sont typés comme des chaînes base64 en JSON. Les champs repeated apparaissent sous forme de tableaux, les maps sous forme d'objets, et les messages imbriqués sont développés en ligne. Ce ne sont pas de vraies données -- ce sont des valeurs types conçues pour amorcer une fixture, un corps de requête Postman ou une réponse d'API simulée, sans avoir à taper un payload réaliste à la main. Comme les valeurs correspondent au type de chaque champ, l'exemple validera face au JSON Schema que l'outil génère à partir du même proto. Collez votre schéma et ouvrez l'onglet JSON d'exemple pour copier ou télécharger un exemple prêt à modifier.

Oui. En plus du JSON Schema, le convertisseur produit du TypeScript prêt à l'emploi : une interface par message et un véritable enum par énumération protobuf, si bien que le résultat s'intègre directement dans un projet et offre un typage vérifié à la compilation. Les types de champs suivent le mappage JSON de protobuf -- chaînes, nombres, booléens, tableaux pour les champs repeated, et marqueurs ? sur les champs optional. Les entiers 64 bits sont typés en string pour éviter toute perte de précision, et les champs bytes sont typés comme des chaînes base64. Les commentaires en ligne de votre .proto sont reportés sous forme de descriptions, ce qui garde les types générés documentés. Cela permet à un frontend de rester synchronisé avec la source de vérité du backend sans recopier les noms de champs à la main à chaque changement de schéma -- c'est précisément là que les fautes de frappe et les décalages s'installent habituellement. Collez votre définition proto3, passez à l'onglet TypeScript, puis copiez le résultat ou téléchargez-le sous forme de types.ts.