gRPC (utviklerperspektiv)
gRPC er binær RPC. Dette verktøyet krever ikke at du forbereder en .proto-fil — så lenge serveren har aktivert Server Reflection, oppdager klienten tjenester og metoder automatisk, og inspiserer deretter felter og kaller dem etter behov.
Kjerneflyt
Slik bruker du det i UI (tre trinn)
Med eksempeltjenesten qrtest.v1.EchoService (grpc://127.0.0.1:18089, plaintext h2c):
- Koble til gRPC-forespørselen (url lagrer
host:port). Reflection kjører automatisk og gir metodetreet:/qrtest.v1.EchoService/Echo— unary/qrtest.v1.EchoService/EchoStream— server-streaming/qrtest.v1.EchoService/Collect— client-streaming/qrtest.v1.EchoService/Chat— bidirectional streaming
- Inspiser skjemaet til
Echo-metoden:- Input
EchoRequest { message: string, count: int32 } - Output
EchoResponse { message: string, seq: int64, metadataJson: string }
- Input
- Kall
Echomed{"message":"hello-grpc","count":3}:- Unary: ett svar
{message:"hello-grpc", seq, metadataJson}, statusOK - Server-streaming
EchoStreammed samme input: 3 framesstream#1/#2/#3
- Unary: ett svar
Metadata (gRPC-headere)
Auth/tracing-headere sendes som metadata med nøkler i små bokstaver; reserverte headere som grpc-* og content-type filtreres ut.
TLS / mTLS
Bruk en grpcs://-Pre-URL og importer klientsertifikater i innstillingene.
Fallgruver (viktig)
- En ikke-OK-status er et normalt forretningsresultat, ikke en tilkoblingsfeil: tidsavbrudd og forretningsfeil kommer tilbake som en statuskode med et muligens tomt svar — ikke behandle dem som transportfeil. Bare HTTP 4xx indikerer en reell feil.
- Verktøyet støtter kun unary og server-streaming; client-streaming / bidirectional streaming kan ikke kalles ennå (for full streaming inne i appen er UI-en autoritativ).
- Komplekse typer:
map-felter vises som nestedemapEntry; indirekte refererte typer trekkes også inn.
Relatert: miljø-Pre-URL-er og TLS-konfigurasjon i konsepter.