メインコンテンツまでスキップ

gRPC(開発者ビュー)

gRPCはバイナリRPCです。このツールは**.protoファイルの準備を求めません** — サーバーがServer Reflectionを有効にしていれば、クライアントがサービスとメソッドを自動検出し、フィールドを確認してその場で呼び出せます。

基本フロー​

UIでの使い方(3ステップ)​

サンプルサービス qrtest.v1.EchoService(grpc://127.0.0.1:18089、平文h2c)を使った例:

  1. gRPCリクエストを接続します(urlは host:port を保存)。Reflectionが自動実行され、メソッドツリーが得られます:
    • /qrtest.v1.EchoService/Echo — 単一応答(unary)
    • /qrtest.v1.EchoService/EchoStream — サーバーストリーミング
    • /qrtest.v1.EchoService/Collect — クライアントストリーミング
    • /qrtest.v1.EchoService/Chat — 双方向ストリーミング
  2. Echo メソッドのスキーマを確認します:
    • 入力 EchoRequest { message: string, count: int32 }
    • 出力 EchoResponse { message: string, seq: int64, metadataJson: string }
  3. {"message":"hello-grpc","count":3} で Echo を呼び出します:
    • Unary:{message:"hello-grpc", seq, metadataJson} の応答1件、ステータス OK
    • 同じ入力でサーバーストリーミング EchoStream:stream#1/#2/#3 の3フレーム

メタデータ(gRPCヘッダー)​

認証 / トレーシングのヘッダーは小文字キーのメタデータとして渡されます。grpc-* や content-type などの予約ヘッダーは除外されます。

TLS / mTLS​

Pre-URLに grpcs:// を使い、設定でクライアント証明書をインポートします。

注意点(重要)​

  • 非OKステータスは正常なビジネス結果であり、接続失敗ではありません:タイムアウトや業務エラーはステータスコードと(空の場合もある)レスポンスとして返ります — トランスポートエラーとして扱わないでください。HTTP 4xxだけが本当のエラーを示します。
  • このツールが対応するのはunaryとサーバーストリーミングのみです。クライアントストリーミング / 双方向ストリーミングはまだ呼び出せません(アプリ内の完全なストリーミングはUIが正です)。
  • 複合型:map フィールドは入れ子の mapEntry として現れます。間接参照される型も読み込みます。

関連:環境のPre-URLとTLS設定は concepts。