gRPC(開発者ビュー)
gRPCはバイナリRPCです。このツールは**.protoファイルの準備を求めません** — サーバーがServer Reflectionを有効にしていれば、クライアントがサービスとメソッドを自動検出し、フィールドを確認してその場で呼び出せます。
基本フロー
UIでの使い方(3ステップ)
サンプルサービス qrtest.v1.EchoService(grpc://127.0.0.1:18089、平文h2c)を使った例:
- gRPCリクエストを接続します(urlは
host:portを保存)。Reflectionが自動実行され、メソッドツリーが得られます:/qrtest.v1.EchoService/Echo— 単一応答(unary)/qrtest.v1.EchoService/EchoStream— サーバーストリーミング/qrtest.v1.EchoService/Collect— クライアントストリーミング/qrtest.v1.EchoService/Chat— 双方向ストリーミング
Echoメソッドのスキーマを確認します:- 入力
EchoRequest { message: string, count: int32 } - 出力
EchoResponse { message: string, seq: int64, metadataJson: string }
- 入力
{"message":"hello-grpc","count":3}でEchoを呼び出します:- Unary:
{message:"hello-grpc", seq, metadataJson}の応答1件、ステータスOK - 同じ入力でサーバーストリーミング
EchoStream:stream#1/#2/#3の3フレーム
- Unary:
メタデータ(gRPCヘッダー)
認証 / トレーシングのヘッダーは小文字キーのメタデータとして渡されます。grpc-* や content-type などの予約ヘッダーは除外されます。
TLS / mTLS
Pre-URLに grpcs:// を使い、設定でクライアント証明書をインポートします。
注意点(重要)
- 非OKステータスは正常なビジネス結果であり、接続失敗ではありません:タイムアウトや業務エラーはステータスコードと(空の場合もある)レスポンスとして返ります — トランスポートエラーとして扱わないでください。HTTP 4xxだけが本当のエラーを示します。
- このツールが対応するのはunaryとサーバーストリーミングのみです。クライアントストリーミング / 双方向ストリーミングはまだ呼び出せません(アプリ内の完全なストリーミングはUIが正です)。
- 複合型:
mapフィールドは入れ子のmapEntryとして現れます。間接参照される型も読み込みます。
関連:環境のPre-URLとTLS設定は concepts。