Apidog Docs
🇯🇵 日本語
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇯🇵 日本語
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇯🇵 日本語
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. リクエスト送信
  • Back to home
  • サポートセンター
  • Apidog サポートセンター
  • インポート/エクスポート
    • APIデータをApidogにインポートする方法
    • Apidog で cURL をインポートする方法
    • Postman の環境を Apidog に移行する方法
    • Swagger/OpenAPI インポート時にエンドポイントを自動グループ化する方法
  • リクエスト送信
    • Apidog は Socket.IO に対応していますか？
    • パラメータ値の「+」がスペースとしてデコードされるのはなぜですか？
    • Apidogでリクエストを送信する方法
    • ApidogでGraphQLリクエストを送信する方法
    • Apidog で gRPC リクエストを送信する方法
    • Apidog で SOAP/WebService リクエストを送信する方法
    • Apidog で WebSocket リクエストを送信する方法
    • Apidog は WebSocket API でプリリクエスト／テストスクリプトおよびアサーションをサポートしていますか？
    • ApidogでSSEリクエストを送信する方法
    • フォルダレベルでデフォルトヘッダーを追加するには？
    • Apidog は gRPC API でプリリクエスト／テストスクリプトおよびアサーションをサポートしていますか？
    • ELANREFUSED.DNS Resolver Error
    • リクエスト送信時に「socket hang up」エラーが発生するのはなぜですか？
    • リクエストエラーの修正
      • read ECONNRESET エラーの修正
      • ECONNREFUSED エラーの修正
      • ETIMEDOUT エラーの修正
      • ENOTFOUND: Couldn't resolve host エラーの修正
      • ENOTFOUND の修正：getaddrinfo ENOTFOUND www エラー
      • connect EHOSTUNREACH エラーの修正
  • API設計
    • パスで変数を使用するにはどうすればよいですか？
    • レスポンスコンポーネントをデフォルトレスポンスとして使用できますか？
    • エンドポイントを変更したユーザーを確認するには？
    • Apidog でエンドポイントフォルダーを一括削除するにはどうすればよいですか？
    • エンドポイントのパスにプレフィックスを一括で追加／削除するにはどうすればよいですか？
    • Schema Editorでプロパティの階層を移動する方法は？
    • 文字列プロパティに複数の列挙値があり、さまざまな場所で使用される場合、この enum を全体で一貫して参照するにはどうすればよいですか？
    • Apidog のリソースフォルダー ID を取得する方法
    • Apidog のリソースフォルダー ID を取得するにはどうすればよいですか？
    • URL パスで変数を使用するにはどうすればよいですか？
    • エンドポイント、ドキュメント、またはテストシナリオを誤って削除した場合はどうすればよいですか？
    • Apidog はカスタムエンドポイントのリクエストコードをサポートしていますか？
    • Swagger/OpenAPI を Apidog にインポートする際にエンドポイントを自動的にグループ化する方法
    • モックレスポンスで重複しない配列データを生成するにはどうすればよいですか？
    • パスで「#」の入力がサポートされていないのはなぜですか？
  • APIデバッグ
    • Apidog はサードパーティのキー管理システムとどのように統合されますか？
    • 同じリクエストが他のツール（Postman など）では正しく動作するのに、Apidog では動作しないのはなぜですか？
    • Apidog でデータベースから変数値を取得する方法
    • 他のツールからApidogへ環境を移行する方法
    • Apidogでスクリプトを使用してアサーションを行う方法
    • JSONPath は配列しか抽出できません。Apidog でその中から単一の要素を抽出するにはどうすればよいですか？
    • 異なる環境でデータベースアカウントの認証情報が異なる場合、Apidog でデータベース操作を設定する方法
    • カスタムスクリプトでサービスのベース URL を取得する方法
    • APIレスポンスが大きすぎる場合、Apidogが最大Node.js文字列長を超過したエラーを報告するのはなぜですか？
    • コンソール出力のサイズ制限はどのくらいですか？大きなファイルを出力するとエラーが発生するのはなぜですか？
    • Windows で DB2 データベース接続エラーを解決する方法
    • Apidog で Oracle Database に接続する際に NJS-045 エラーが表示されるのはなぜですか？
    • Apidog のカスタムスクリプトで動的な値を生成する方法
    • 同じエンドポイントへのクライアントリクエストは成功するのに、Web 側でデバッグすると「Unable to request address」というエラーが発生するのはなぜですか？
    • レスポンスが大きすぎる場合、Apidog がエラーを報告するのはなぜですか？
    • Apidog の記録エンドポイントはどのように使用しますか？
    • エンドポイントのレスポンスを定義する際、エンドポイントにレスポンス内容がないことは許可されますか？
    • カスタムスクリプトでサービスの baseURL を取得するにはどうすればよいですか？
    • Apidog で元のパケットを表示するにはどうすればよいですか？
    • リクエストの実行時に「Invalid URI xxx」エラーが表示されるのはなぜですか？
    • Apidog スクリプトで非同期リクエストを行うにはどうすればよいですか？
    • リクエスト送信時に「Couldn't resolve host」というメッセージが表示されるのはなぜですか？
    • コンソールの出力サイズ制限とは何ですか？大きなファイルを出力するとエラーが発生するのはなぜですか？
    • エンドポイントリクエストでファイルをアップロードするにはどうすればよいですか？
    • Apidog がクラッシュする、またはレスポンスデータが表示されない場合の対処方法
    • Apidog が OAuth2.0 で使用する公式リダイレクト URI
  • モックAPIデータ
    • APIを自動的にモックする方法
    • Apidog のモックで何ができますか？
    • Apidog で固定の API データをモックする方法
    • Apidogで条件付きデータをモックする方法
    • Apidogでクラウドモックを有効にする方法
    • Apidog でセルフホスト型モックを有効にする方法
    • Apidog は WebSocket API のモックをサポートしていますか？
    • モックエンドポイントをリクエストしたときにブラウザがコンテンツを返さないのはなぜですか？
  • 自動テスト
    • ローカルクライアントではテストシナリオが問題なく実行されるのに、Apidog CLI または runner で実行するとエラーが発生するのはなぜですか？
    • Apidogでテストシナリオを作成する方法
    • テストステップ間でデータを渡す方法
    • 事前ステップのデータを正常に参照できないのはなぜですか？
    • Apidog で foreach ループを使用する方法
    • エンドポイント／エンドポイントケースからデータを同期する場合の違いは何ですか？
    • Apidogでテストデータを使用する方法
    • Apidog のスクリプトでテストデータを取得する方法
    • Apidog でテストシナリオを一括実行する方法
    • Apidogでテストタスクをスケジュールする方法
    • Apidog でパフォーマンステストを実行する方法
    • パフォーマンステストで実際のリクエストとレスポンスを確認するにはどうすればよいですか？
    • Apidog でパフォーマンステストレポートをエクスポートするにはどうすればよいですか？
    • データベースクエリの結果を、ループする API リクエストのパラメータとして使用する方法
    • CI/CD 中に ApiDog で Stripe Webhook をキャプチャして検証する
    • Runner で「Error: unable to verify the first certificate on runner」エラーを解決する方法
    • General Runner Docker コンテナの「Not Found」エラー。
    • Apidog Web版でGeneral Runnerのサーバーホストを設定する方法
    • スケジュールされたテストシナリオが 0 リクエストで終了するのはなぜですか？
    • Runner または CLI でファイルアップロードパラメータが見つからない場合はどうすればよいですか？
    • アップロードファイルのステップを含むテストシナリオを Runner で実行する方法
    • Runner で「Error: unable to verify the first certificate on runner」エラーを解決するにはどうすればよいですか？
    • Runner に問題が発生した場合、問題を特定するために Runner ログへアクセスして検索するにはどうすればよいですか？
    • エンドポイントのパラメータがアップロードファイルで、Runner または CLI で見つからない場合はどうすればよいですか？
    • API ユースケースが変更されたときに、テストステップが自動的に同期されないのはなぜですか？
    • Markdown ドキュメントで複数のドル記号を使用すると、一部のコンテンツが正しく表示されないのはなぜですか？
    • セルフホスト型 Runner はタスクの実行後にサーバー上でテストレポートを生成しますか？
    • テストシナリオ内のリクエストに統一されたプリ／ポストプロセッサを追加できますか？
    • 1 回の自動テスト実行中に動的な値の一貫性を保つにはどうすればよいですか？
  • APIドキュメントの公開
    • 公開ドキュメント内のすべての Apidog ロゴを非表示にする方法
    • API 仕様が更新された場合、API ドキュメントも変更されますか？
    • Apidog で共同作業者に API を共有する方法
    • Apidog ドキュメントのドメインをカスタマイズする方法
    • Apidogで複数バージョンのドキュメントを作成する方法
    • Apidog の Publish Docs Sites における共有範囲
    • Apidog における Share Doc リストの共有範囲
    • 公開された Share Docs にホスト名が表示されないのはなぜですか？
    • 共有ドキュメントでドキュメント利用者が Base URL を変更するには？
    • 公開済みの Apidog ドキュメントを複製して自分のプロジェクトで使用できますか？
    • Apidog オンラインドキュメントでヘッダー（例：トークン）を共有する方法
    • チームメンバーが公開済みドキュメントを見つけられないのはなぜですか？
    • カスタムドメインで SSL 証明書の有効期限切れまたは Cloudflare 526 エラーを修正するにはどうすればよいですか？
    • カスタム SMTP は正常に設定されているが、許可リストに登録されたユーザーが OTP メールを受信できない
  • Markdown
    • Apidog 内のさまざまなページやエンドポイントにリンクするためにカードを使用する方法
    • Markdown ドキュメントで複数の $ 記号を使用すると、一部のコンテンツが正しく表示されないのはなぜですか？
    • Apidog Markdown で透明背景画像を使用する方法
    • Markdown テーブルの列幅を設定する方法
    • Markdown ドキュメントに内部 API、ドキュメント、データスキーマ、またはフォルダーを挿入するにはどうすればよいですか？
    • Apidog のカードコンポーネント内で、プロジェクト内のドキュメントまたはエンドポイントへのリンクを追加するにはどうすればよいですか？
  • ブランチ
    • スプリントブランチにアクセスするには？
  • 管理
    • Apidog クライアントをサイレントインストールする方法
    • 管理者アクセス権があるにもかかわらず「No Permission」エラーが表示されるのはなぜですか？
    • Runner のバージョン番号を確認するにはどうすればよいですか？
    • Apidog は win7 をサポートしていますか？
    • インストール後に Apidog で「Cannot locate program entry point DiscardVirtualMemory in dynamic link library KERNEL32.dll」というエラーが表示されるのはなぜですか？
    • サブスクリプションの変更と返金
    • Web Requests Work, But App Gets "read ECONNRESET"—なぜですか？
    • Windows システム更新後に Apidog を開けないのはなぜですか？
    • Windows システム更新後に Apidog が開かなくなる理由
  • 請求
    • Apidog でチーム用に別の請求アカウントを設定できますか？
    • Apidog におけるチームアクセスおよび請求の問題
    • 招待されたチームメンバーが Apidog にアクセスできません。
    • 個人の有料チームを組織に移行する
  • オンプレミス
    • Apidog セルフホスト（Enterprise）版におけるユーザーおよびアクセス管理
  • Webとクライアント
    • Linux デスクトップ版のダウンロードとインストール
  1. リクエスト送信

Apidog で gRPC リクエストを送信する方法

gRPC は、さまざまなシナリオで広く使用されている、効率的で高速かつ信頼性の高い Remote Procedure Call（RPC）フレームワークです。マイクロサービスアーキテクチャにおいて、Apidog はサービス間の効率的な通信を促進します。大量のデータ転送を伴うシナリオでは、Apidog はストリーミング機能を活用して、ネットワーク遅延と帯域幅の消費を削減します。
gRPC API デバッグ機能は現在 Beta テスト段階です。gRPC API デバッグ機能を使用するには、Apidog のバージョンが 2.3.0 以上である必要があります。

新しい gRPC プロジェクトを作成する#

Apidog ホームページの「New Project」ボタンをクリックし、「gRPC Project (Beta)」を選択します。

Proto をインポートする#

gRPC は API-First アプローチに従います。つまり、開発前に .proto ファイルを通じてサービス、メソッド、メッセージを定義する必要があります。そのため、Apidog を使用して gRPC API をデバッグする前に、API 定義として機能する .proto ファイルをインポートする必要があります。

初回インポート#

現在、.proto ファイルをインポートする方法は 2 つあります。
ローカルファイル
.proto ファイルをホストしている URL
選択した .proto ファイルは 1 つの Proto としてインポートされます。サービスはサービスとしてインポートされ、rpc はメソッドとしてインポートされます。
選択した .proto ファイルが他の .proto ファイルに依存している場合は、依存関係のディレクトリを手動で追加する必要があります。
選択した .proto ファイルが依存している他の .proto ファイル内のサービスも、その package が選択した .proto ファイルと同じ package に属している場合、同じ Proto にインポートされます。

再インポート#

インポートした .proto ファイルに変更があった場合、Apidog で再インポートできます。Proto を右クリックし、「Reimport」ボタンをクリックします。

呼び出しメソッド#

.proto ファイルを使用して gRPC メソッドを定義する場合、Apidog は次の 4 種類をサポートしています。
Unary: 単方向呼び出し
Server Streaming: サーバー側ストリーミング
Client Streaming: クライアント側ストリーミング
Bidirectional Streaming: 双方向ストリーミング
Apidog は 4 種類すべてのメソッドタイプをサポートしています。

Unary 呼び出し#

Unary 呼び出しは HTTP リクエストに似ています。アドレスバーに URL を入力し、Message タブで JSON 形式のメッセージ内容を入力して、「Invoke」ボタンをクリックすると、Unary 呼び出しが開始されます。
さらに、認証やその他の複雑なシナリオに対応するために、Metadata と Auth 情報を手動で入力できます。

ストリーミング呼び出し#

ストリーミング呼び出しは WebSocket 接続に似ています。呼び出しを開始した後、Message タブでメッセージを作成して送信できます。サーバーストリーミング、クライアントストリーミング、双方向ストリーミングは、ストリーミング呼び出しタイプに該当します。
Apidog は、呼び出しステータス、送信メッセージ、受信メッセージを時系列で一元的に表示するタイムラインビューを提供します。メッセージをクリックすると、メッセージの詳細を簡単に確認できます。

高度な使用方法#

動的な値を自動生成する#

Apidog は .proto ファイル内の内容を認識できるため、「Auto-generate」ボタンをクリックしてメッセージボディを生成できます。より柔軟な動的データについては、「Dynamic Values」機能を使用して式を設定・生成できます。
詳細な手順については、「Dynamic Values」 を参照してください。

変数を使用する#

gRPC メッセージおよび Metadata で Apidog 変数を使用できます。詳細な手順については、「Environment Variable Types」 ドキュメントを参照してください。

TLS を有効にする#

gRPC API は、TLS による安全な接続の確立をサポートしています。
Apidog では、URL の前にあるプロトコルセレクターをクリックして、TLS の状態をすばやく切り替えることができます。
さらに、Apidog は URL で grpcs:// を使用して接続の TLS を有効にすることにも対応しています。一方、grpc:// は TLS が有効になっていないことを示します。

サーバーアドレスと環境を管理する#

URL アドレスバーの右側にあるプラスアイコンをクリックして、現在使用しているサーバーアドレスを環境に追加します。
次に、右上で環境とサーバーアドレスを選択し、URL アドレスバーで「Follow Default」を選択すると、すべてのメソッドのデバッグに統一されたサーバーアドレスを使用できます。

Proto ファイルと API パラメータを表示する#

Proto ファイルの内容を表示する#

Apidog では、左側のディレクトリツリーで Proto をクリックすると、.proto ファイルの生の内容を表示できます。

リクエストおよびレスポンスパラメータを表示する#

gRPC はシリアライズ形式として ProtoBuf を使用します。つまり、メッセージの送受信時には、各メッセージが ProtoBuf 形式で伝送されます。JSON や XML などの他のテキストベースのシリアライズ形式とは異なり、ProtoBuf はバイナリ形式であるため、人間による記述や読み取りには適していません。そのため、Apidog で gRPC API を呼び出す場合、すべてのメッセージは JSON 形式で記述および表示されます。
API 情報ページで、JSON 形式で表されたリクエストおよびレスポンスパラメータを確認できます。
ProtoBuf と JSON には、以下の表に示すようなデータ型のマッピング関係があります。
ProtoBuf 3JSONJSON の例
messageobject{"fooBar": v, "g": null, …}
enumstring"FOO_BAR"
map<K,V>object{"k": v, …}
repeated Varray[v, …]
boolbooleantrue, false
stringstring"Hello World!"
bytesbase64 string"YWJjMTIzIT8kKiYoKSctPUB+"
int32, fixed32, uint32number1, -10, 0
int64, fixed64, uint64string"1", "-10"
float, doublenumber1.1, -10.0, 0, "NaN", "Infinity"

デバッグ情報を保存する#

デバッグが完了したら、「Save」ボタンをクリックして、現在のメソッドのサーバー URL、メッセージ、Metadata などを保存し、他のチームメンバーがデバッグできるようにします。
Modified at 2026-06-11 07:06:02
Previous
ApidogでGraphQLリクエストを送信する方法
Next
Apidog で SOAP/WebService リクエストを送信する方法
Built with