gRPC (visão do desenvolvedor)
gRPC é RPC binário. Esta ferramenta não exige que você prepare um arquivo .proto — desde que o servidor ative Server Reflection, o cliente descobre serviços e métodos automaticamente, depois inspeciona campos e invoca sob demanda.
Fluxo principal
Como usar na UI (três passos)
Usando o serviço de exemplo qrtest.v1.EchoService (grpc://127.0.0.1:18089, h2c em texto puro):
- Conecte a requisição gRPC (a url armazena
host:port). A Reflection roda automaticamente e gera a árvore de métodos:/qrtest.v1.EchoService/Echo— unary/qrtest.v1.EchoService/EchoStream— server-streaming/qrtest.v1.EchoService/Collect— client-streaming/qrtest.v1.EchoService/Chat— bidirectional streaming
- Inspecione o schema do método
Echo:- Entrada
EchoRequest { message: string, count: int32 } - Saída
EchoResponse { message: string, seq: int64, metadataJson: string }
- Entrada
- Invoque
Echocom{"message":"hello-grpc","count":3}:- Unary: uma resposta
{message:"hello-grpc", seq, metadataJson}, statusOK - Server-streaming
EchoStreamcom a mesma entrada: 3 framesstream#1/#2/#3
- Unary: uma resposta
Metadados (cabeçalhos gRPC)
Cabeçalhos de autenticação/tracing são passados como metadados com chaves em minúsculas; cabeçalhos reservados como grpc-* e content-type são filtrados.
TLS / mTLS
Use um Pre-URL grpcs:// e importe certificados de cliente nas configurações.
Pontos de atenção (importante)
- Um status não-OK é um resultado normal de negócio, não uma falha de conexão: timeouts e erros de negócio voltam como código de status com uma resposta possivelmente vazia — não os trate como erros de transporte. Apenas HTTP 4xx indica erro real.
- A ferramenta suporta apenas unary e server-streaming; client-streaming / bidirectional streaming ainda não podem ser invocados (para streaming completo no app, a UI é a autoridade).
- Tipos complexos: campos
mapaparecem comomapEntryaninhados; tipos referenciados indiretamente também são carregados.
Relacionado: Pre-URLs de ambiente e configuração TLS em concepts.