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. テストシナリオ
  • Apidog ラーニングセンター
  • はじめに
    • Apidog の概要
    • Apidog の基本概念
    • Apidog のナビゲーション
    • クイックスタート
      • 概要
      • エンドポイントの作成
      • リクエストの作成
      • アサーションの追加
      • テストシナリオの作成
      • APIドキュメントの共有
      • さらに詳しく
    • Apidogへの移行
      • 概要
      • 手動インポート
      • スケジュールインポート(データソースのバインド)
      • インポートオプション
      • データのエクスポート
      • インポート元
        • Postman からのインポート
        • OpenAPI 仕様のインポート
        • cURL のインポート
        • Markdown のインポート
        • Insomnia からインポート
        • apiDoc からインポート
        • .har ファイルをインポート
        • WSDL のインポート
  • モックAPIデータ
    • 概要
    • Smart Mock
    • カスタムモック
    • モック優先順位
    • モックスクリプト
    • Cloud Mock
    • セルフホスト Runner モック
    • モック言語(ロケール)
  • アカウントと設定
    • アカウント設定
    • OpenAPI アクセストークンの生成
    • 通知
    • 言語設定
    • ホットキー
    • ネットワークプロキシ設定
    • データのバックアップ
    • Apidog の更新
    • アカウントの削除
    • 実験的機能
  • リクエスト送信
    • 概要
    • SSE デバッグ
    • MCP Client
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP または WebService
    • GraphQL
    • gRPC
    • デバッグにリクエストプロキシエージェントを使用する
    • リクエスト作成
      • リクエスト履歴
      • リクエストの基本
      • パラメータとボディ
      • リクエストヘッダー
      • リクエスト設定
      • リクエストのデバッグ
      • リクエストをエンドポイントとして保存する
      • HTTP/2
    • 認証と認可
      • 概要
      • CA 証明書とクライアント証明書
      • 認可タイプ
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Hawk 認証
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • レスポンスとCookie
      • APIレスポンスの表示
      • Cookie の管理
      • 概要
  • APIの開発とデバッグ
    • 概要
    • リクエストの生成
    • リクエストの送信
    • デバッグケース
    • テストケース
    • 動的値
    • レスポンスの検証
    • Design-First と Request-First
    • コード生成
    • 環境と変数
      • 概要
      • 変数の使用
      • 環境管理
    • Vaultシークレット
      • 概要
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • 動的値モジュール
      • Airline
      • Animal
      • Color
      • Commerce
      • 会社
      • Database
      • データ型
      • 日付
      • Finance
      • Food
      • Git
      • Hacker
      • Helpers
      • 画像
      • Internet
      • Location
      • Lorem
      • 音楽
      • Number
      • Person
      • Phone
      • Science
      • 文字列
      • システム
      • Vehicle
      • Word
    • プリプロセッサとポストプロセッサ
      • 概要
      • アサーション
      • 変数の抽出
      • Wait
      • セキュリティ
      • データベース操作
        • 概要
        • MySQL
        • MongoDB
        • Redis
        • Oracle Client
      • スクリプトの使用
        • 概要
        • プリプロセッサスクリプト
        • ポストプロセッサスクリプト
        • Public Scripts
        • Postman Scripts Reference
        • 他のプログラミング言語の呼び出し
        • JS ライブラリの使用
        • レスポンスの可視化
        • スクリプト例
          • アサーションスクリプト
          • 変数の使用
          • リクエストの変更
          • その他の例
    • APIデバッグ
      • AI Agent Debugger
      • A2A Debugger
  • API設計
    • 概要
    • 新しい API プロジェクトを作成する
    • エンドポイントの基本
    • API設計ガイドライン
    • モジュール
    • 複数のリクエストボディ例を設定する
    • コンポーネント
    • 共通フィールド
    • グローバルパラメータ
    • エンドポイント変更履歴
    • コメント
    • エンドポイントの一括管理
    • カスタムプロトコル API
    • Spec-first Mode(ベータ)
    • セキュリティスキーム
      • 概要
      • セキュリティスキームを作成する
      • セキュリティスキームを使用する
      • オンラインドキュメントにおけるセキュリティスキーム
    • 高度な機能
      • カスタムエンドポイントフィールド
      • 関連するテストシナリオ
      • エンドポイントステータス
      • パラメータ一覧の表示形式
      • エンドポイントの一意識別
    • スキーマ
      • 概要
      • 新しいスキーマを作成する
      • スキーマを構築する
      • JSON などからスキーマを生成
      • oneOf、allOf、anyOf
      • Discriminator の使用
  • APIテスト
    • 概要
    • テストシナリオ
      • テストシナリオを作成する
      • リクエスト間でデータを受け渡す
      • フロー制御条件
      • エンドポイントおよびエンドポイントケースからデータを同期する
      • 他のプロジェクトからエンドポイントとエンドポイントケースをインポートする
      • テストシナリオのエクスポート
    • テストレポート
      • テストレポート
    • テストシナリオの実行
      • テストシナリオを実行する
      • テストシナリオを一括実行する
      • データ駆動テスト
      • 共有テストデータ
      • スケジュールされたタスク
      • 他のプロジェクトの API の実行環境を管理する
    • テストスイート
      • 概要
      • テストスイートを作成する
      • テストスイートを編成する
      • テストスイートをローカルで実行する
      • CLI でテストスイートを実行する
      • スケジュールタスク
    • APIのテスト
      • 統合テスト
      • パフォーマンステスト
      • エンドツーエンドテスト
      • 回帰テスト
      • コントラクトテスト
    • Apidog CLI
      • 概要
      • Apidog CLI のインストールと実行
      • Apidog CLI オプション
    • CI/CD
      • 概要
      • Github Actions との連携
      • Gitlab との統合
      • Jenkins との連携
      • Git コミットによるテストのトリガー
  • APIドキュメントの公開
    • 概要
    • サポートされているAPI技術
    • クイック共有
    • API ドキュメントの閲覧
    • Markdown ドキュメント
    • ドキュメントサイトの公開
    • カスタムログインページ
    • カスタムレイアウト
    • カスタム CSS、JavaScript、HTML
    • カスタムドメイン
    • AI 機能
    • SEO 設定
    • 詳細設定
      • ドキュメント検索
      • CORS プロキシ
      • Google Analytics の連携
      • フォルダツリー設定
      • 表示設定
      • ドキュメントURLへの値の埋め込み
    • APIバージョン
      • 概要
      • API バージョンの作成
      • API バージョンの公開
      • API バージョンを指定したエンドポイントの共有
  • ブランチ
    • 概要
    • スプリントブランチの作成
    • ブランチでAPIをテストする
    • ブランチで API を設計する
    • スプリントブランチのマージ
    • スプリントブランチの管理
    • AI Branch(ベータ)
  • AI機能
    • 概要
    • AI機能の有効化
    • テストケースの生成
    • AI によるスキーマの変更
    • エンドポイントコンプライアンスチェック
    • APIドキュメント完全性チェック
    • AIを活用したフィールド命名
    • FAQ
  • Apidog MCPサーバー
    • 概要
    • Apidog プロジェクトを AI に接続する
    • 公開済みドキュメントを AI に接続する
    • OpenAPI ファイルを AI に接続する
  • ベストプラクティス
    • API署名の処理
    • OAuth 2.0 で保護された API へのアクセス
    • コラボレーションワークフロー
    • 認証状態の管理
  • オフラインスペース
    • 概要
  • 管理
    • プロジェクト管理
      • プロジェクトの管理
      • 通知設定
      • プロジェクトメンバーの管理
      • プロジェクトリソース
        • データベース接続
        • Git 接続
    • チーム管理
      • チームの管理
      • チームメンバーの管理
      • チームアクティビティ
      • チームのロールと権限
      • チームリソース
        • General Runner
        • チーム変数
        • リクエストプロキシエージェント
      • リアルタイムコラボレーション
        • チームコラボレーション
    • オンボーディングチェックリスト
      • 基本概念
      • オンボーディングガイド
    • 組織管理
      • 組織の管理
      • 組織ロールと権限
      • プラン管理
        • 組織の請求管理者
      • シングルサインオン(SSO)
        • SSO 概要
        • Microsoft Entra ID の設定
        • Okta の設定
        • 組織の SSO を設定する
        • ユーザーアカウントの管理
        • グループをチームにマッピングする
      • SCIMプロビジョニング
        • SCIM プロビジョニングの概要
        • Microsoft Entra ID
        • Okta
      • 組織リソース
        • セルフホスト Runner
  • 請求
    • 概要
    • クレジット
    • プランのアップグレード
    • 代替支払い方法
    • サブスクリプションの管理
    • 有料チームの組織への移動
  • Apidog Europe
    • Apidog Europe
  • アドオン
    • API Hub
    • Apidog Intellij IDEA プラグイン
    • ブラウザ拡張機能
      • Chrome
      • Microsoft Edge
    • リクエストプロキシ
      • Web でのリクエストプロキシ
      • 共有ドキュメントにおけるリクエストプロキシ
      • クライアントでのリクエストプロキシ
  • データとセキュリティ
    • データストレージとセキュリティ
    • ユーザーデータのプライバシーとセキュリティ
    • リクエストルーティングとデータセキュリティ
  • リファレンス
    • APIデザインファーストアプローチ
    • Apidog OpenAPI 仕様拡張
    • JSONPath
    • XPath
    • 正規表現
    • JSON Schema
    • CSVファイル形式
    • Java 環境のインストール
    • Runner デプロイ環境
    • Apidog Markdown 構文
    • Apidog Swagger拡張
      • 概要
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Apidog JSON Schema拡張
      • 概要
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • サポートセンター
  1. テストシナリオ

リクエスト間でデータを受け渡す

自動テストのシナリオでは、複数のリクエスト間でデータを受け渡すことは非常に一般的です。典型的なケースには、次のようなものがあります。
リクエスト 1 がトークンを返すログインリクエストであり、リクエスト 2 がこのトークンを使用して他のデータをリクエストする場合。
リクエスト 1 が ID を返し、リクエスト 2 がこの ID に基づいて操作を実行する場合。
リクエスト 1 がリストを返し、リクエスト 2 がこのリスト内のデータを使用する場合。
このようなシナリオに対して、Apidog はリクエスト間のデータ受け渡しを処理するために 2 つの異なるソリューションを提供しています。直面している具体的な問題に基づいて、適切なソリューションを選択できます。
方法利点制限事項利用可能範囲
事前ステップのデータを取得シンプルで、追加の変数が不要ですデータを複数回参照する必要がある場合はやや煩雑ですTests モジュールのみ
変数を使用複数回参照する場合に便利です1 回だけ参照する場合はやや複雑ですTests および APIs モジュール

事前ステップのデータを取得#

リクエスト 1 がトークンを返すログインリクエストであり、リクエスト 2 がこのトークンを使用して追加データをリクエストするシナリオを考えてみましょう。
1
ログインリクエスト(リクエスト 1)をテストシナリオに追加します。
2
クエリリクエスト(リクエスト 2)をテストシナリオに追加します。
3
リクエスト 2 のクエリパラメータには、リクエスト 1 が返したトークンを含める必要があります。リクエスト 2 のクエリパラメータ内のトークンフィールドで「魔法の杖」アイコン 🪄 をクリックし、「事前ステップのデータを取得」を選択します。
4
データ取得元としてリクエスト 1 を選択し、レスポンスボディを選択して、JSONPath を使用してリクエスト 1 が返したトークンを抽出します。例:$.token。
5
Insert をクリックすると、{{$.2.response.body.token}} がクエリパラメータとして挿入されます。
6
テストシナリオで「Run」ボタンをクリックすると、リクエスト 1 からリクエスト 2 へデータを正常に受け渡せます。
「事前ステップのデータを取得」機能は「Tests」モジュールでのみ利用可能であり、「APIs」モジュールでは利用できません。
「事前ステップのデータを取得」を使用する場合、値はテストシナリオ全体をまとめて実行した場合にのみ取得できます。個別のステップを実行する場合はアクセスできません。

変数構文を使用した事前ステップデータの参照#

前述の {{$.2.response.body.token}} の例を使用します。
'2' はステップ ID を表し、各テストステップで確認できます。
'response.body' は、事前ステップからのデータの位置を示します。これには、リクエストのヘッダー、ボディ、またはレスポンスのヘッダーやボディなどのデータを含めることができます。詳細は以下を参照してください。
'token' は、ボディ内の次の階層にある 'token' データを表します。JSONPath 構文を使用して、必要なデータを抽出できます。
事前ステップのデータは、リクエストパラメータ、ヘッダー、認証など、リクエストのさまざまな部分で利用できます。また、以下のように、データをリクエストボディに直接挿入することもできます。
注意すべき点として、スクリプト内で事前ステップのデータを使用する必要がある場合、{{variable}} 構文で変数を直接参照することはできません。代わりに、pm.variables.get を使用して事前ステップのデータを参照してください。例:

構文リファレンス#

カテゴリ機能構文例
リクエストURL{{$.<step id>.request.url}}
パスパラメータ{{$.<step id>.request.pathParam.<field name>}}
クエリ{{$.<step id>.request.query.<field name>}}
ヘッダー{{$.<step id>.request.header.<field name>}}
ボディ(form){{$.<step id>.request.body.<field name>}}
ボディ(json){{$.<step id>.request.body.<field path>}}
レスポンスボディ{{$.<step id>.response.body.<field path>}}
ヘッダー{{$.<step id>.response.header.<field name>}}
Cookie{{$.<step id>.response.cookie.<field name>}}
ループ要素(ForEach ループ内の配列要素){{$.<loop step id>.element.<field path>}}
インデックス{{$.<loop step id>.index}}

変数を使用してデータを受け渡す#

リクエスト 1 がトークンを返すログインリクエストであり、リクエスト 2 がこのトークンを使用して追加データをリクエストするシナリオを考えてみましょう。
1
ログインリクエスト(リクエスト 1)をテストシナリオに追加します。
2
リクエスト 1 の後処理で、「変数を抽出」アクションを追加し、$.token を {{token}} として抽出します。
変数を抽出 の詳細をご覧ください。
3
クエリリクエスト(リクエスト 2)をテストシナリオに追加します。
4
リクエスト 2 のクエリパラメータで変数 {{token}} を参照します。
5
テストシナリオで「Run」ボタンをクリックすると、リクエスト 1 からリクエスト 2 へデータを正常に受け渡せます。

FAQ#

Q: 事前ステップのデータを正常に参照できないのはなぜですか?
A: まず、現在「Tests」モジュールにいることを確認してください。「事前ステップのデータを参照」機能は Tests モジュールでのみ利用可能であり、APIs モジュールでは利用できません。
現在確実に Tests モジュールにいる場合は、「Actual Request」タブに切り替えて、リクエストで参照している事前ステップのデータが正常に組み込まれているか確認してください。
実際のリクエスト内の参照が、実データではなく {{$.n.response.body.abc}} のまま表示されている場合、その参照が適用されていないことを示します。
この場合、次の一般的な理由を確認してください。
1.
単一のステップだけではなく、テストシナリオ全体を実行しましたか?事前ステップのデータ参照を有効にするには、完全なテストシナリオを実行する必要があります。
2.
ステップ ID が正しく、参照しようとしているステップに対応しているか確認してください。
3.
使用している JSONPath がデータソースと正確に一致していることを確認してください。
Modified at 2026-06-11 07:06:02
Previous
テストシナリオを作成する
Next
フロー制御条件
Built with