Protobuf a JSON Schema

El conversor de Protobuf a JSON Schema es una herramienta online gratuita que convierte definiciones proto3 en JSON Schema, interfaces TypeScript y JSON de ejemplo. Admite mensajes, enums, tipos anidados, oneof, map y repeated. Funciona por completo en tu navegador, sin instalación ni registro.

Proto3: mensajes, enums, mensajes anidados, repeated, optional, oneof, campos map y todos los tipos escalares.

Tres: JSON Schema (Draft-07 con $ref), interfaces TypeScript y JSON de ejemplo con valores de marcador de posición.

Se asignan a string tanto en JSON Schema como en TypeScript, siguiendo la convención estándar de mapeo JSON de protobuf para enteros de 64 bits.

Sí, el conversor de Protobuf a JSON Schema es 100 % gratuito, sin registro, sin tarifas ocultas y sin límites de uso. Todo el procesamiento se realiza localmente en tu navegador, garantizando una privacidad total.

Por supuesto. El conversor de Protobuf a JSON Schema procesa todo en el lado del cliente, dentro de tu navegador. No se sube ni se almacena ningún dato en ningún servidor. Tu contenido permanece siempre privado en tu dispositivo.

Sí, el conversor de Protobuf a JSON Schema es totalmente adaptable y funciona en smartphones y tabletas. Puedes usarlo en cualquier dispositivo con un navegador web moderno, sin necesidad de descargar ninguna app.

No se necesita cuenta ni registro. Simplemente abre el conversor de Protobuf a JSON Schema en tu navegador y empieza a usarlo de inmediato. No hay muros de registro ni restricciones de uso.

El conversor de Protobuf a JSON Schema admite una amplia variedad de formatos y lenguajes populares. Consulta la interfaz de la herramienta para ver la lista completa de opciones compatibles.

Solo tienes que introducir tu entrada en el campo correspondiente, ajustar las opciones a tu gusto y la herramienta la procesará al instante. Luego puedes copiar el resultado al portapapeles o descargarlo.

Un archivo .proto es la definición fuente de Protocol Buffers: declara mensajes, campos, tipos y números de campo usados para serializar datos binarios compactos para gRPC y APIs de alto rendimiento. Un JSON Schema describe la forma de un documento JSON para que los validadores puedan comprobar que los payloads entrantes o salientes tienen los campos y tipos correctos. Ambos sirven a la misma idea -- un contrato de datos -- pero en mundos distintos: protobuf gobierna el formato binario de transmisión, mientras que JSON Schema gobierna el JSON legible por humanos usado en APIs web, configuraciones y documentación. Convertir uno en el otro te permite validar JSON contra la misma estructura que tus servicios ya aplican en binario. Esta herramienta lee una definición proto3 y genera un JSON Schema Draft-07, usando punteros $ref hacia un bloque definitions compartido, para que puedas insertarlo directamente en un validador sin reescribir los nombres de campo a mano.

Los tipos enteros de sesenta y cuatro bits -- int64, uint64, sint64, fixed64 y sfixed64 -- se representan como strings en lugar de números tanto en el JSON Schema como en el JSON de ejemplo. Esto no es una peculiaridad del conversor, sino que sigue el mapeo oficial de Protobuf a JSON. El tipo number de JavaScript es un flotante de doble precisión que solo puede representar de forma segura enteros hasta 2^53, así que un valor real de 64 bits podría perder precisión silenciosamente si se interpreta como número. Codificarlo como string preserva cada dígito y viaja sin problemas entre lenguajes. Los enteros de treinta y dos bits como int32 y uint32 se mantienen como números normales, ya que caben sin problema. Conocer esto evita sorpresas de validación cuando un backend envía un ID grande o una marca de tiempo. Pega tu esquema aquí y la herramienta aplica automáticamente la regla string-versus-número para cada campo numérico.

Cada construcción de protobuf se mapea a su equivalente natural en JSON. Un campo repeated se convierte en un array JSON y en un tipo array de TypeScript, ya que contiene cero o más valores. Un campo map<key, value> se representa como un objeto JSON usando additionalProperties para tipar los valores, porque los maps de protobuf son colecciones clave-valor. Un bloque oneof emite todos sus campos miembro, y el JSON Schema registra que las opciones son mutuamente excluyentes, de modo que solo una puede estar establecida a la vez. Los campos optional pasan a no ser obligatorios en el schema y obtienen un ? en la interfaz de TypeScript, mientras que los tipos escalares y los mensajes anidados se resuelven mediante punteros $ref. Esto significa que esquemas complejos del mundo real se traducen fielmente en lugar de aplanarse o descartarse. Haz clic en Sample .proto para cargar un ejemplo que incluye un campo repeated, un map y un oneof, y luego compara las pestañas para ver exactamente cómo se maneja cada uno.

La pestaña de JSON de ejemplo construye un objeto completo rellenando cada campo con un valor representativo para que puedas ver de inmediato la forma del mensaje. Un string se convierte en "example", un double se convierte en 3.14, los campos enteros reciben números de muestra, y un campo bytes muestra un string corto codificado en base64 como "dGVzdA==", porque los bytes se tipan como strings base64 en JSON. Los campos repeated aparecen como arrays, los maps como objetos, y los mensajes anidados se expanden en línea. Estos no son datos reales -- son valores de relleno tipados pensados para poblar un fixture, el cuerpo de una petición de Postman o la respuesta de una API simulada sin tener que escribir un payload realista a mano. Como los valores coinciden con el tipo de cada campo, el ejemplo pasará la validación contra el JSON Schema que la herramienta genera a partir del mismo proto. Pega tu esquema y abre la pestaña de JSON de ejemplo para copiar o descargar un ejemplo listo para editar.

Sí. Junto con el JSON Schema, el conversor produce código TypeScript listo para usar: una interface por cada mensaje y un enum real por cada enumeración de protobuf, de modo que el resultado se inserta directamente en un proyecto y ofrece tipado en tiempo de compilación. Los tipos de campo siguen el mapeo de Protobuf a JSON -- strings, números, booleanos, arrays para los campos repeated y marcadores ? en los campos optional. Los enteros de sesenta y cuatro bits se tipan como string para evitar pérdida de precisión, y los campos bytes se tipan como strings base64. Los comentarios en línea de tu .proto se trasladan como descripciones, manteniendo documentados los tipos generados. Esto mantiene el frontend sincronizado con la fuente de verdad del backend sin copiar nombres de campo a mano cada vez que el esquema cambia, que es donde suelen aparecer los errores tipográficos y el desajuste. Pega tu definición proto3, cambia a la pestaña de TypeScript y luego copia el resultado o descárgalo como types.ts.