Skip to content

gRPC

Restura speaks gRPC over Connect and gRPC-Web transports — both available on web and desktop without any local toolchain. JSON encoding is the default; binary protobuf is supported where the server allows.

  • Server reflection — the fastest path. Hit the Reflect button and Restura lists available services and methods.
  • Upload a .proto — drag in your .proto file and Restura compiles it on the fly. Imports are resolved from the same directory.
  • Paste a FileDescriptorSet — for monorepos that already ship a compiled *.binpb.
  • Unary — request-response.
  • Server streaming — single request, streamed responses. Live updates land in the response panel.
  • Client streaming — multiple requests, single response. desktop for full HTTP/2 streaming; browser fetch limits client streaming on the web target.
  • Bidirectional streaming — same caveat as client streaming.

All the HTTP auth schemes apply (Bearer is the common one), plus:

  • AWS SigV4 signed at the wire (Worker / Electron, not the renderer).
  • Custom metadata — gRPC uses metadata in place of HTTP headers; the same editor adds them.

Restura auto-injects a W3C traceparent header on every gRPC request by default — useful when your services participate in distributed tracing. Override or disable in the request settings.

The Cloudflare Worker has a dedicated route /api/grpc/reflection that proxies reflection calls with the right wire framing — so the web app gets the same reflect-and-go experience as desktop.