Comment les types Protobuf sont-ils mappés à JSON Schema ?

Le convertisseur suit les conventions de mappage standard de Protobuf3. Par exemple, `string` et `bytes` deviennent des types `string` dans JSON Schema, tandis que les types numériques comme `int32` sont mappés à `number` ou `integer` avec des contraintes de plage.

Mon schéma API est-il envoyé à un serveur ?

Non. La logique d'analyse et de transformation est exécutée localement à l'aide de JavaScript dans votre navigateur, ce qui garantit la confidentialité de vos définitions Protobuf.

Puis-je convertir de JSON Schema vers .proto ?

Oui, l'outil est bidirectionnel. Vous pouvez coller un JSON Schema pour générer des définitions de message Protobuf équivalentes, bien que les balises de documentation et les options de service gRPC spécifiques puissent nécessiter un ajustement manuel.

Prend-il en charge les messages et les énumérations imbriqués ?

Oui. L'outil traite récursivement les messages imbriqués, les énumérations et les champs `oneof` dans leurs représentations `definitions` ou `anyOf` correspondantes dans JSON Schema.

Formateurs & Code

gRPC .proto ⇄ JSON Schema

Bridge protobuf and JSON Schema definitions.

Runs in your browser

.proto · source

lines: 9chars: 138size: 138 B

JSON Schema · result

{
  "User": {
    "type": "object",
    "properties": {
      "id": {
        "type": "integer"
      },
      "email": {
        "type": "string"
      },
      "name": {
        "type": "string"
      },
      "active": {
        "type": "boolean"
      },
      "tags": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    }
  }
}

lines: 25chars: 375size: 375 B

live

Note de la rédaction

Understanding · Two schema languages — one for wire, one for validation.

Ce chapitre approfondi n'est actuellement disponible qu'en anglais. L'outil de conversion ci-dessus fonctionne dans votre langue ; le long article explicatif n'a pas encore été traduit.

Questions fréquentes

Quick answers.

›How are protobuf types mapped to JSON Schema?

The converter follows standard proto3 mapping conventions. For example, `string` and `bytes` become `string` types in JSON Schema, while numeric types like `int32` are mapped to `number` or `integer` with range constraints.

›Is my API schema sent to a server?

No. The parsing and transformation logic is executed locally using JavaScript in your browser, keeping your protobuf definitions confidential.

›Can I convert from JSON Schema back to .proto?

Yes, the tool is bidirectional. You can paste a JSON Schema to generate equivalent protobuf message definitions, though documentation tags and specific gRPC service options may require manual adjustment.

›Does it support nested messages and enums?

Yes. The tool recursively processes nested messages, enums, and `oneof` fields into their corresponding `definitions` or `anyOf` representations in JSON Schema.

Les internautes recherchent aussi

Outils similaires

More in this room.

Tout voir dans Formateurs & Code