gRPC (vista de desarrollador)
gRPC es RPC binario. Esta herramienta no te exige preparar un archivo .proto: mientras el servidor tenga activada la Server Reflection, el cliente descubre servicios y métodos automáticamente, inspecciona campos y los invoca a demanda.
Flujo principal
Cómo usarlo en la UI (tres pasos)
Con el servicio de ejemplo qrtest.v1.EchoService (grpc://127.0.0.1:18089, h2c sin cifrar):
- Conecta la solicitud gRPC (la URL guarda
host:port). La reflection se ejecuta automáticamente y devuelve el árbol de métodos:/qrtest.v1.EchoService/Echo— unaria/qrtest.v1.EchoService/EchoStream— streaming de servidor/qrtest.v1.EchoService/Collect— streaming de cliente/qrtest.v1.EchoService/Chat— streaming bidireccional
- Inspecciona el esquema del método
Echo:- Entrada
EchoRequest { message: string, count: int32 } - Salida
EchoResponse { message: string, seq: int64, metadataJson: string }
- Entrada
- Invoca
Echocon{"message":"hello-grpc","count":3}:- Unaria: una respuesta
{message:"hello-grpc", seq, metadataJson}, estadoOK - Streaming de servidor
EchoStreamcon la misma entrada: 3 tramasstream#1/#2/#3
- Unaria: una respuesta
Metadatos (cabeceras gRPC)
Las cabeceras de auth/tracing se pasan como metadatos con claves en minúsculas; las cabeceras reservadas como grpc-* y content-type se filtran.
TLS / mTLS
Usa una Pre-URL grpcs:// e importa certificados de cliente en los ajustes.
Advertencias (importante)
- Un estado distinto de OK es un resultado de negocio normal, no un fallo de conexión: los timeouts y los errores de negocio vuelven como código de estado con una respuesta posiblemente vacía — no los trates como errores de transporte. Solo un HTTP 4xx indica un error real.
- La herramienta solo admite unaria y streaming de servidor; el streaming de cliente / bidireccional aún no se puede invocar (para streaming completo dentro de la app, manda la UI).
- Tipos complejos: los campos
mapaparecen comomapEntryanidados; los tipos referenciados indirectamente también se importan.
Relacionado: Pre-URLs de entorno y configuración TLS en los conceptos clave.