Saltar al contenido principal

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):

  1. 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
  2. Inspecciona el esquema del método Echo:
    • Entrada EchoRequest { message: string, count: int32 }
    • Salida EchoResponse { message: string, seq: int64, metadataJson: string }
  3. Invoca Echo con {"message":"hello-grpc","count":3}:
    • Unaria: una respuesta {message:"hello-grpc", seq, metadataJson}, estado OK
    • Streaming de servidor EchoStream con la misma entrada: 3 tramas stream#1/#2/#3

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 map aparecen como mapEntry anidados; los tipos referenciados indirectamente también se importan.

Relacionado: Pre-URLs de entorno y configuración TLS en los conceptos clave.