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でテストシナリオを作成する方法

テストシナリオを作成する#

Apidogを開いたら、「Tests」モジュールに移動し、検索バーの横にある+をクリックして新しいテストシナリオを作成します。適切なディレクトリを選択し、優先度を設定して作成を完了します。

テストステップを追加する#

Apidogでテストシナリオを設定したら、リクエストを追加し始めることができます。リクエストを追加する方法はいくつかあり、それぞれ異なるニーズや柔軟性に合わせて用意されています。
1.
API仕様に関連付けられたリクエスト—これらのリクエストは、API仕様の変更に応じて更新できます。
a. エンドポイント仕様からインポート: この方法では、API仕様内の構造化された定義からリクエストを直接インポートします。これにより、テストがAPIのドキュメント化されたインターフェースと一致します。ただし、特定のテスト条件を満たすために、リクエストパラメータを手動で調整する必要がある場合があります。
b. エンドポイントケースからインポート: このオプションを使用すると、設定済みのパラメータを含む、事前定義されたエンドポイントケースからリクエストを取得できます。これは、実際のAPI利用をシミュレートする標準化されたテストに特に有用であり、テスト実行間の一貫性を確保できます。
2.
API仕様に関連付けられていない独立したリクエスト—これらのリクエストは、API仕様の変更に応じて更新されません。より高度なカスタマイズが可能です。
a. カスタムリクエストを追加: 特定の要件に合わせてテストシナリオを調整するため、リクエストを一から作成します。この方法では、既存のAPI仕様の範囲を超えて検証するための最大限の柔軟性が得られます。
b. cURLから追加: cURLを活用することで、カスタマイズされたリクエストを効率的にインポートまたは作成できます。API仕様に制約されることなく、複雑または独自のAPI連携を模倣するリクエストをすばやく作成する便利な方法です。
3.
他のテストシナリオを参照する:
a. 他のテストシナリオからリクエストを含める: この方法では、プロジェクト内ですでに定義されている別のテストシナリオから、特定のリクエストをインポートできます。
b. 他のテストシナリオを参照: 包括的なテストでは、別のテストシナリオ全体を使用する必要がある場合があります。この機能により、関連するすべてのテストと設定を統合でき、設定作業の重複を避け、統一されたテスト戦略を促進できます。

エンドポイント仕様からインポート#

現在のプロジェクトからエンドポイント仕様をテストシナリオのステップとしてインポートできます。エンドポイントをインポートする際には、「Manual」と「Automated」の2つのモードがあります。より詳しい手順については、Sync Data from APIs/API Casesを参照してください。
Manual
「Manual」モードでは、プロジェクト内のエンドポイントドキュメントに対する変更は、テストステップ内のエンドポイントに即座には反映されません。テストデータの同期は、テスターが「Manual」ボタンを有効にした場合にのみ行われます。なお、テストステップデータに加えた変更は、「Manual Sync」をクリックしてもエンドポイントドキュメントを更新しません。代わりに、このボタンをクリックすると、同期のためにテストシナリオがエンドポイントドキュメントから情報を取得できるようになります。
Automated
「Automated」モードでは、プロジェクト内のエンドポイントドキュメントに加えられた変更は、テストステップに同期的に更新されます。
1つのテストシナリオで他のプロジェクトのエンドポイントをテストする必要がある場合は、Import Endpoints/Cases from Other Projects to Test Stepsを参照してください。

エンドポイントケースからインポート#

現在のプロジェクトまたは他のプロジェクトからエンドポイントケースをインポートすることを選択できます。エンドポイントケースをインポートする際には、**「Copy」と「Reference」**の2つのモードがあります。
Copy
エンドポイントケースを**「Copy」**としてインポートすると、エンドポイントケース内のパラメータもテストステップにコピーされます。これらは互いに独立しており、それぞれの変更が他方に影響することはありません。手動同期を選択できます。
Reference
エンドポイントケースを**「Reference」**としてインポートすると、リクエストには元のプロジェクトのエンドポイントケースが直接使用されます。

カスタムリクエストを追加する#

作業プロセスでは、サードパーティの決済エンドポイントなど、プロジェクト外のエンドポイントを呼び出す必要がある場合があります。
テストステップにカスタムAPIリクエストを追加できます。カスタムリクエストは、一般的なGET、POST、PUT、DELETEなどを含む、任意のHTTPリクエストにできます。

cURLから追加#

実際の作業プロセスでは、多くのエンドポイントリクエストがcURLコマンドラインの形式で提示されます。ワンクリックでcURLリクエストをテストステップにインポートできます。

他のテストシナリオからステップを含める#

同じプロジェクト内の他のテストシナリオからインポートすることで、テストステップまたはプロセス制御条件を複製できます。

他のテストシナリオを参照する#

他のテストシナリオをテストステップとして参照できます。ユースケースは2つあります。
1.
ビジネスプロセスに、共通で再利用可能なAPIテストステップがある場合、これらのステップを小さなテストシナリオにまとめ、それを他のより広範なテストシナリオで直接参照できます。
2.
製品全体の主要プロセスを回帰テストする必要がある場合、テストシナリオ内で各サブテストシナリオを参照して組み立て、すべての主要プロセスのテスト回帰作業をワンクリックで完了できます。
無限ループや、テストシナリオが正常に実行停止できない状況を防ぐため、他のテストシナリオを参照する機能では、元のテストシナリオ自体を参照することはできません。

テストシナリオを構成する#

任意のテストステップをクリックすると、構成モードに入ります。このモードでは、より広い操作ページを使用して、各テストステップの詳細内容をより適切かつ効率的に入力できます。ページの左側にはテストシナリオ全体のフローが表示され、右側には選択したテストステップの詳細が表示されます。エンドポイントリクエストとテストプロセス制御コンポーネントでは、異なる表示パネルが表示されます。
ステップの前にある≡をドラッグすることで、ステップの順序を調整できます。
このモードでは、「⬆️」キーと「⬇️」キーを使用して、選択したテストステップ間をすばやく切り替えることができます。
構成モードでは、複数のステップを編集してから、左上隅の「Save All」ボタンをクリックして、すべての変更を保存できます。
未保存の変更があるステップは、左側のリストバーでドット付きで表示されます。行った変更は必ず保存するようにしてください。
Modified at 2026-06-11 07:06:02
Previous
ローカルクライアントではテストシナリオが問題なく実行されるのに、Apidog CLI または runner で実行するとエラーが発生するのはなぜですか？
Next
テストステップ間でデータを渡す方法
Built with