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. APIの開発とデバッグ
  • 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. APIの開発とデバッグ

動的値

Apidog でエンドポイントをデバッグしていると、リクエストパラメータやリクエストボディなどに、値、名前、住所、その他のデータポイントを作成する必要がよくあります。このような場合に、動的値機能が役立ちます。
動的値を使用すると、リクエストを送信するたびに、事前定義されたルールに基づいて新しい値を生成できます。これにより、デバッグプロセスを効率化し、各リクエストに一意のデータが含まれるようにできます。

はじめに#

1
エンドポイントで、Run タブに切り替えます。
2
動的化したいパラメータについて、元の値を削除し、値の右側にある magic wand アイコンをクリックします。この例では、name パラメータを選択します。
3
Data generator をクリックし、Person.firstName など、必要な動的値の種類を選択します。
4
Insert をクリックして、動的値をパラメータに挿入します。
5
Send をクリックします。Actual request で、実際に送信された名前が "Jennifer" であることを確認できます。
6
もう一度リクエストを送信すると、新しい名が動的に生成されます。

JSON ボディで動的値を使用する#

JSON ボディを POST する必要があり、JSON 内の一部の値を動的に生成する必要がある場合も、動的値を使用できます。
1
JSON ボディを持つ POST エンドポイントを見つけ、Run タブに切り替えます。
2
JSON ボディで Generate automatically -> Generate field names をクリックすると、仕様で定義されたプロパティ名を取得できます。
3
カーソルを正しい位置に置き、 Insert dynamic value をクリックして、Data Generator を選択します。
4
適切なデータ型を選択し、Insert をクリックします。
5
すべてのフィールドに値を追加します。
6
Send をクリックします。Actual request セクションで、実際に送信された JSON ボディを確認できます。
7
もう一度リクエストを送信すると、動的値によって新しい JSON ボディが生成されます。

カスタム式で動的値を使用する#

情報の文字列をカスタマイズする必要があり、その情報内の一部の値を動的に生成する必要がある場合は、Custom expression をクリックして動的値式を入力することもできます。
1
動的式をクリックして入力ボックスを開きます。
2
連結などの方法で動的値式を入力し、期待する内容を生成します。下部で生成された情報をリアルタイムにプレビューできます。
3
Insert をクリックします。パラメータ値セクションでカスタム式を確認できます。
一般的なカスタム動的値の例を以下に示します。さらに多くの動的値メソッドを確認するには、Dynamic Values Modules をクリックすることもできます。
目的のカスタム内容カスタム式戻り値の例メソッドの連結と意味
タイムスタンプ付きのランダムなユーザー名{{$internet.userName}}_{{$date.now}}"Kattie_Rice64_2024-09-04T05:51:42.413Z"{{$internet.userName}} を使用してランダムなユーザー名を生成し、{{$date.now}} を使用して現在時刻を取得し、テンプレートリテラルで連結します。
会社ドメイン付きのランダムなメールアドレス`{{person.lastName}}@{{$company.namelower}}.com`"Kole.Haag@schmidt-schoen.com"
番地と部屋番号付きのランダムな住所{{$location.buildingNumber}} {{$location.street}}, Apt. {{$number.int(min=1,max=1000)}}, {{$location.city}}, {{$location.state(abbreviated=true)}} {{$location.zipCode}}"723 Klein Inlet, Apt. 814, North Myron, DE 67605"複数のメソッドを使用して、番地、通り名、部屋番号、市、州、郵便番号を含む詳細な住所を生成します。
業界と会社タイプを含むランダムな会社名{{$company.buzzAdjective}} {{$company.buzzNoun}} {{$company.name}}"web-enabled architectures Fay Inc"company メソッドを使用して、業界説明と会社タイプを含む会社名を生成します。
過去 1 年以内のランダムな日付{{$date.past(years=1)}}"2023-10-24T09:25:24.109Z"{{$date.past(years=1)}} メソッドを使用して、過去 1 年以内のランダムな日付を生成します。
通貨記号付きのランダムな価格{{$finance.currencySymbol}}{{$commerce.price}}"KM12.89"{{$finance.currencySymbol}} を使用してランダムな通貨記号を生成し、{{$commerce.price}} を使用してランダムな価格を生成して、それらを連結します。
ランダムな商品説明{{$commerce.productAdjective}} {{$commerce.productMaterial}} {{$commerce.product}} - {{$lorem.sentences(min=2,max=4)}}"Small Wooden Pizza - Thema copiose dens adinventitias a. Causa uxor terreo defleo vitiosus animi. Ademptio possimus decet considero absorbeo sursum rem circumvenio antiquus curatio. Adipisci addo tredecim carbo."{{$commerce.productAdjective}} および {{$lorem.sentences(min=2,max=4)}} メソッドを使用して、商品の特徴と説明を含むテキストを生成します。
ハッシュタグ付きのランダムな文#{{$lorem.slug(min=1,max=3)}} {{$lorem.sentence(min=1,max=3)}}"#provident-quidem-tempore Vita comprehendo id."{{$lorem.slug(min=1,max=3)}} を使用してランダムなハッシュタグを生成し、文の前に連結します。
ポート番号付きのランダムな IP アドレス{{$internet.ipv4}}::{{$number.int(min=1024,max=65535)}}"246.222.133.63::56332"{{$internet.ipv4}} を使用してランダムな IP アドレスを生成し、{{$number.int(min=1024,max=65535)}} を使用してポート番号を生成して、それらを連結します。
クエリパラメータ付きのランダムな URL{{$internet.url}}?{{$lorem.slug}}={{$lorem.word}}"https://nippy-bob.name/?nemo-provident-clementia=blandior"{{$internet.url}}、{{$lorem.slug}}、{{$lorem.word}} を使用して、クエリパラメータ付きのランダムな URL を生成します。
ランダムなファイルパス/path/to/{{$lorem.slug}}/{{$system.fileName}}"/path/to/caritas-solio-vilicus/across.img"{{$lorem.slug}}、{{$system.fileName}}、文字列連結を使用して、ランダムなファイルパスを生成します。
ランダムなデータベーステーブル名`table_{{$string.alphanumeric(length=5)lower}}`"table_brxlr"
ランダムな HTML コードスニペット<p>{{$lorem.sentence}} <a href="{{$internet.url}}">{{$lorem.word}}</a></p><p>Calamitas velociter una succurro depopulo. <a href="https://feline-king.name/">comminor</a></p>{{$lorem.sentence}} と {{$internet.url}} を使用して、リンクを含むランダムな HTML コードスニペットを生成します。
ランダムな HTTP リクエストヘッダー{ "User-Agent": {{$internet.userAgent}}, "Referer": {{$internet.url}} }{ "User-Agent": Opera/13.25 (Macintosh; Intel Mac OS X 10.7.9 U; HE Presto/2.9.171 Version/12.00), "Referer": https://queasy-dusk.info/ }{{$internet.userAgent}} と {{$internet.url}} を使用して、User-Agent と Referer を含むランダムな HTTP リクエストヘッダーを生成します。

動的変数のユースケース#

動的変数は、API テストにおいて幅広い用途があります。代表的な例をいくつか示します。
実世界のデータのシミュレーション: ユーザー名、住所、さまざまな形式のメールアドレスなど、異なる種類のデータを API がどのように処理するかをテストする必要があります。動的変数を使用すると、実世界のシナリオに近い大量のテストデータを簡単に生成でき、テストカバレッジを向上できます。
一意の値の生成: 特定のテストシナリオでは、注文番号、ユーザー ID、取引 ID の生成など、データの一意性を確保する必要があります。動的変数は、タイムスタンプや乱数に基づいて一意の値を生成できるため、データ競合を防ぎ、正確なテスト結果を保証できます。
データ処理の効率化: 各テスト実行ごとに手動でデータを変更する代わりに、動的変数を使用して必要なデータを自動生成します。これにより、大幅な時間と労力を節約し、テスト効率を高められます。

動的値を手動で挿入する#

動的変数を挿入する必要がある入力フィールドで、{{$ と入力すると、動的変数リストを表示できます。
目的の変数は、以下のいずれかの方法で素早く見つけられます。
完全入力: たとえば $timestamp のように、完全な動的変数名を正確に入力します。
あいまい一致: time などの一部のキーワードを入力すると、システムが一致する動的変数を自動的にフィルタリングして表示します。
対象の動的変数を選択すると、入力フィールドに挿入されます。
TIP
この方法では、動的変数にパラメータや関数を直接追加することはサポートされていません。

Data Generator#

Data Generator を使用すると、必要に応じて任意のカスタムデータを生成できます。
パラメータ入力フィールドにマウスを合わせ、表示される magic wand アイコンをクリックすると、より強力な Data Generator パネルが開きます。
パネル内では、次の 2 つの方法で目的の動的変数を見つけられます。
変数タイプで検索: 「Date」「String」「Number」などの動的変数タイプを選択することで、目的の変数スコープを素早く特定でき、検索効率が向上します。
キーワードで検索: 上部の「Type」入力ボックスに「time」などのキーワードを入力すると、システムが一致する動的変数を自動的にフィルタリングして表示するため、素早く見つけやすくなります。
目的の動的変数を選択したら、より細かなデータ生成ニーズを満たすために、以下の操作でさらに調整できます。
メソッドの追加: 一部の動的変数は追加メソッドをサポートしています。たとえば、{{$date.now}} では addDays メソッドを使用して日数を追加し、特定の日付のデータを生成できます。
処理関数の追加: すべての動的変数の結果は関数で処理できます。たとえば、md5 関数を使用して文字列を暗号化し、セキュリティ要件を満たすテストデータを生成できます。
Expression エリアには、現在選択している動的変数、メソッド、関数が明確に表示されるため、簡単に確認および変更できます。
Preview エリアには、動的変数によって生成されたサンプルデータがリアルタイムで表示されます。Preview エリアの末尾にある Refresh ボタンをクリックすると、新しいサンプルデータが生成され、データ生成の効果を簡単に確認できます。
Preview エリア内のサンプルデータをクリックすると、内容が自動的にコピーされるため、必要な場所に貼り付ける際に便利です。

Constant#

Constant を使用すると、静的テキストの一部を Dynamic Value 構文でラップし、その後に処理関数を追加できます。一般的なユースケースには、MD5 ハッシュ化、Base64 エンコード、大文字・小文字の変更 などがあります。
定数を使用する場合は、元の値を入力し、構文内で必要な処理関数を手動で追加します。実行時に、システムが暗号化または変換を自動的に処理します。
値が純粋に静的で、処理を必要としない場合は、Constant を使用せずにプレーンテキストとして直接入力できます。

データの言語/国を設定する#

Apidog の動的変数は、多言語環境でのテストニーズを満たすために、異なる言語のサンプルデータ生成をサポートしています。手順は次のとおりです。
1.
Data Generator パネルを開きます。
2.
日付と時刻以外の動的変数タイプについては、動的変数の右上にある設定ボタンをクリックし、対象の言語を選択します。
3.
日付と時刻の動的変数タイプについては、format および locale メソッドを使用して言語と形式を指定できます。

強力な日付操作とフォーマット#

Apidog は豊富な日付および時刻の動的値を提供するだけでなく、開発プロセスの簡素化にも取り組んでいます。簡単に実現できる機能をいくつか示します。
柔軟な時刻調整: add メソッドを使用すると、現在時刻を基準に時間単位を簡単に加算または減算できます。たとえば、{{$date.now|addHours(-3)}} は現在時刻より 3 時間前の日付を返します。
多様な日付フォーマット: format メソッドを使用すると、必要に応じて日付をさまざまな形式にフォーマットできます。たとえば、{{$date.now|formatISO}} は ISO 8601 標準に従って日付をフォーマットします。
正確なタイムゾーン制御: timezone パラメータを設定することで、日付のタイムゾーンを簡単に制御できます。たとえば、{{$date.now|format('yyyy-MM-dd HH:mm:ss',timezone='America/Port-au-Prince')}} は UTC+8:00 タイムゾーンの現在時刻に対応する日付を返します。

一般的な動的変数#

Apidog Dynamic Values を最大限に活用できるように、利用可能な値の包括的な一覧を明確な例とともにまとめました。Dynamic Values Modules をクリックすると、必要な値を素早く見つけ、その効果的な使用方法を学べます。
TIP
Apidog アプリケーション内で Dynamic Value 式にマウスを合わせると、簡単な説明と例を表示することもできます。
Modified at 2026-06-11 07:06:02
Previous
テストケース
Next
レスポンスの検証
Built with