Online Tool Store
Constructor de solicitudes gRPC
Pega un archivo .proto, elige el servicio y el método, y obtén un comando grpcurl correcto con TLS, tiempo de espera y soporte para Windows/PowerShell.
🔒 Esta herramienta funciona totalmente en tu navegador. Tus archivos nunca se suben a un servidor.
Herramienta de navegador
Constructor de solicitudes gRPC
Limitación del navegador: los navegadores no pueden abrir conexiones gRPC en bruto (basadas en trailers de HTTP/2), así que esta herramienta no puede llamar directamente a tu servidor. En su lugar, construye un comando grpcurl correcto y listo para ejecutar a partir de tu endpoint, tu proto y tu solicitud - cópialo en una terminal para enviar realmente la llamada.
—
Metadatos (cabeceras)
Opciones avanzadas (certificados TLS, tiempos de espera, tamaño de mensaje, formato de salida)
Cómo funciona
- Pega tu archivo .proto - la herramienta lo analiza localmente para encontrar servicios, métodos y si cada uno es unario o de streaming.
- Elige un servicio y un método en los menús desplegables, o escribe manualmente un símbolo totalmente calificado si el análisis no encuentra ninguno.
- Completa el mensaje de la solicitud en JSON y añade las cabeceras de metadatos que necesites (por ejemplo, un token de autenticación).
- Elige la seguridad de la conexión - texto plano, TLS sin verificación, o TLS verificado - y elige un origen del esquema: tu archivo .proto local (sin necesidad de reflection) o server reflection.
- Abre "Opciones avanzadas" si necesitas certificados TLS mutuos, un plazo de connect/max-time, un tamaño máximo de mensaje, o salida en texto protobuf en lugar de JSON.
- Elige el shell en el que vas a ejecutar el comando - macOS/Linux, PowerShell, o cmd.exe - para que el escapado de comillas coincida exactamente con ese shell.
- Copia o descarga el comando (o script) grpcurl generado y ejecútalo en una terminal para enviar realmente la solicitud.
FAQ
¿Con qué ayuda esta herramienta?
Analiza un archivo .proto para encontrar tus servicios y métodos, te permite construir el mensaje de la solicitud, los metadatos, la configuración TLS y de timeout, y genera un comando grpcurl correcto y calificado por paquete que puedes ejecutar para hacer la llamada real.
¿Por qué no puede llamar directamente a mi servidor gRPC?
Los navegadores no pueden abrir una conexión gRPC en bruto - gRPC depende de trailers y framing de HTTP/2 que solo un cliente nativo (o un proxy gRPC-Web) puede manejar. Generar el comando grpcurl exacto es la forma honesta y correcta de darte una llamada funcional desde una herramienta de navegador.
¿Envía mi proto o mis datos a algún sitio?
No. El análisis, la construcción de la solicitud y la generación del comando se ejecutan todos localmente en tu navegador - no se sube nada.
¿Qué pasa si mi proto no se puede analizar?
El analizador maneja un único archivo .proto autocontenido (sin imports entre archivos). Si no encuentra definiciones de servicio, la herramienta cambia a un modo manual donde tú mismo escribes el símbolo Service/Method totalmente calificado.
¿Qué es grpcurl, y necesito instalarlo por separado?
grpcurl es una herramienta de línea de comandos real - como curl, pero para gRPC. Esta página solo genera el comando; igualmente necesitas tener grpcurl instalado (por ejemplo, vía brew o go install) para ejecutarlo realmente contra tu servidor.
¿Necesito tener server reflection habilitado en mi servidor gRPC para usar esto?
No, por defecto no. Con "Local .proto file" seleccionado como origen del esquema, el comando generado pasa tu proto a grpcurl mediante -proto y -import-path, así que nunca depende de server reflection. Si tu servidor sí expone reflection y prefieres saltarte el paso del archivo, cambia el origen del esquema a "Server reflection" y el comando usará -use-reflection en su lugar.
¿Soporta mutual TLS (certificados de cliente)?
Sí. Abre "Opciones avanzadas" para configurar una ruta de certificado CA, certificado de cliente y clave de cliente - la herramienta solo añade -cacert, -cert o -key cuando corresponden a la seguridad de conexión elegida (por ejemplo, -cacert se omite en conexiones -insecure, ya que grpcurl lo ignora ahí).
¿Puedo configurar un timeout o un plazo de conexión?
Sí - "Opciones avanzadas" tiene campos para el timeout de conexión (-connect-timeout) y el tiempo total máximo de la llamada (-max-time), además de un tamaño máximo de mensaje de respuesta (-max-msg-sz), todos opcionales.
¿El comando generado funciona en Windows?
Sí. Usa el selector "Command syntax for" para cambiar entre el escapado de shell de macOS/Linux, PowerShell y cmd.exe - cada uno usa las reglas de escapado reales de ese shell, y el script descargable coincide (.sh, .ps1, o .bat).
Cómo nos comparamos
| Función | Online Tool Store | EaseCloud gRPC Client | Newtum API Navigator gRPC Client |
|---|---|---|---|
| Genera un símbolo grpcurl correcto y calificado por paquete (package.Service/Method) | Sí | No - omite el prefijo de paquete | N/A - envía en vivo en su lugar |
| Analiza un .proto pegado para listar servicios y métodos automáticamente | Sí | Solo entrada manual | Requiere server reflection |
| Detecta el tipo de RPC unario vs. streaming a partir del proto | Sí | No | Se muestra tras conectar |
| Constructor de cabeceras de metadatos con escapado seguro para el shell | Sí | No | Sí |
| El comando realmente evita reflection al usar un proto local (añade -proto/-import-path, no solo una afirmación) | Sí | No - no genera el flag -proto, así que recurre silenciosamente a reflection | N/A - siempre en vivo |
| Soporte de mutual TLS (-cacert / -cert / -key) | Sí | No | No |
| Flags de timeout de conexión, tiempo máximo y tamaño máximo de mensaje | Sí | No | N/A - se configura en la conexión en vivo |
| Escapado de comando correcto para bash/zsh, PowerShell y cmd.exe | Sí | No - solo un estilo de shell | N/A - sin salida de comando |
| Sin registro, sin necesidad de una llamada de red en vivo | Sí | Sí | No - requiere un servidor accesible |
Como un navegador no puede hablar gRPC en bruto, la salida honesta y útil es un comando correcto - y acertar con el símbolo calificado por paquete, el flag -proto libre de reflection, y las reglas de escapado propias de cada shell es justo donde falla una implementación ingenua.