gRPC (ontwikkelaarsweergave)
gRPC is binaire RPC. Deze tool vraagt je geen .proto-bestand voor te bereiden — zolang de server Server Reflection aanzet, ontdekt de client services en methoden automatisch, en kun je velden inspecteren en naar behoefte aanroepen.
Kernstroom
Gebruik in de UI (drie stappen)
Gebruikmakend van de voorbeelddienst qrtest.v1.EchoService (grpc://127.0.0.1:18089, platte h2c):
- Verbind het gRPC-verzoek (url slaat
host:portop). Reflection draait automatisch en levert de methodeboom op:/qrtest.v1.EchoService/Echo— unary/qrtest.v1.EchoService/EchoStream— server-streaming/qrtest.v1.EchoService/Collect— client-streaming/qrtest.v1.EchoService/Chat— bidirectioneel streamen
- Inspecteer het schema van de
Echo-methode:- Invoer
EchoRequest { message: string, count: int32 } - Uitvoer
EchoResponse { message: string, seq: int64, metadataJson: string }
- Invoer
- Roep
Echoaan met{"message":"hello-grpc","count":3}:- Unary: één antwoord
{message:"hello-grpc", seq, metadataJson}, statusOK - Server-streaming
EchoStreammet dezelfde invoer: 3 framesstream#1/#2/#3
- Unary: één antwoord
Metadata (gRPC-headers)
Auth/tracing-headers worden als metadata met kleine letters doorgegeven; gereserveerde headers zoals grpc-* en content-type worden uitgefilterd.
TLS / mTLS
Gebruik een grpcs://-Pre-URL en importeer clientcertificaten in de instellingen.
Valkuilen (belangrijk)
- Een niet-OK-status is een normaal zakelijk resultaat, geen verbindingsfout: timeouts en zakelijke fouten komen terug als statuscode met mogelijk leeg antwoord — beschouw ze niet als transportfouten. Alleen HTTP 4xx duidt op een echte fout.
- De tool ondersteunt alleen unary en server-streaming; client-streaming / bidirectioneel streamen kan nog niet worden aangeroepen (voor volledig streamen in de app is de UI leidend).
- Complexe typen:
map-velden verschijnen als genestemapEntry; indirect gerefereerde typen worden ook meegenomen.
Gerelateerd: omgeving-Pre-URLs en TLS-configuratie in concepts.