Ga naar hoofdinhoud

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

  1. Verbind het gRPC-verzoek (url slaat host:port op). 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
  2. Inspecteer het schema van de Echo-methode:
    • Invoer EchoRequest { message: string, count: int32 }
    • Uitvoer EchoResponse { message: string, seq: int64, metadataJson: string }
  3. Roep Echo aan met {"message":"hello-grpc","count":3}:
    • Unary: één antwoord {message:"hello-grpc", seq, metadataJson}, status OK
    • Server-streaming EchoStream met dezelfde invoer: 3 frames stream#1/#2/#3

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 geneste mapEntry; indirect gerefereerde typen worden ook meegenomen.

Gerelateerd: omgeving-Pre-URLs en TLS-configuratie in concepts.