Apidog Docs
🇯🇵 日本語
  • 🇺🇸 English
  • 🇯🇵 日本語
HomeLearning CenterSupport CenterAPI References
HomeLearning CenterSupport CenterAPI References
Discord Community
Slack Community
X / Twitter
🇯🇵 日本語
  • 🇺🇸 English
  • 🇯🇵 日本語
  1. Apidog CLI
  • Apidog学習センター
  • はじめに
    • Apidog紹介
    • Apidog基本操作
      • 概要
      • 新しい APIを作成
      • APIにリクエストを送信
      • アサーションを追加
      • テストシナリオを作成
      • APIドキュメントを共有
      • さらなる探究
      • リクエストを送信してAPIとして保存
    • Apidog基本知識
      • Apidog操作方法
      • Apidogの基本概念
    • 移行
      • 概要
      • 手動インポート
      • 定期インポート
      • インポートオプション
      • データのエクスポート
      • Import from...
        • Postman からインポート
        • OpenAPI(Swagger)仕様のインポート
        • cURLのインポート
        • Markdownのインポート
        • Insomniaからのインポート
        • apiDocからのインポート
        • .harファイルのインポート
        • WSDLのインポート
  • API設計
    • 概要
    • コンポーネント
    • 常用フィールド
    • グローバルパラメータ
    • API変更履歴
    • プロジェクトの作成
    • 一括API管理
    • APIの基本
    • 複数のリクエストボディ例の設定
    • Schemas
      • 概要
      • 新規Schemaの作成
      • スキーマを構築する
      • JSONなどからのSchema生成
    • Security schemes
      • 概要
      • Security Schemeの作成
      • Security Schemeの使用
      • オンラインドキュメントにおけるSecurity Scheme
    • 高度な機能
      • APIをテストステップとしてインポート
      • パラメータリストの表示形式
      • APIのカスタムフィールド
      • APIのステータス
      • API固有識別子
  • API開発 & デバッグ
    • 概要
    • リクエストの生成
    • リクエストの送信
    • コード生成機能
    • APIケース
    • 動的な値
    • レスポンス検証
    • 設計優先 & リクエスト優先
    • 環境 & 変数
      • 概要
      • 環境とサービス
      • 変数の使い方
    • Vault secrets
      • 概要
      • AWS Secrets Manager
      • Azure Key Vault
      • HashiCorp Vault
    • 前/後処理
      • 概要
      • Wait
      • 変数の抽出
      • アサーション
      • データベース操作
        • 概要
        • MongoDB
        • Redis
        • Oracle クライアント
      • スクリプト利用
        • 概要
        • 前処理スクリプト
        • 後処理スクリプト
        • Postmanスクリプトリファレンス
        • 共通スクリプト
        • 他のプログラミング言語の呼び出し
        • JSライブラリの使用
        • レスポンスの可視化
        • スクリプトの例
          • その他の例
          • スクリプトを使用したリクエストメッセージの変更
          • スクリプトでの変数の使用
          • アサーションスクリプト
    • 動的値モジュール
  • APIモック
    • 概要
    • スマートMock
    • カスタムMock
    • Mockの優先順位
    • Mockスクリプト
    • クラウドMock
    • セルフホストランナーMock
    • Mock言語 (ロケール)
  • 自動テスト
    • 概要
    • テストレポート
    • テストシナリオ
      • テストシナリオの作成
      • 他のプロジェクトからAPI/APIケースをインポートする
      • リクエスト間でデータを渡す
      • API/APIケースからのデータ同期
      • フロー制御条件
      • テストシナリオのエクスポート
    • テストシナリオ実行
      • データ駆動型テスト
      • スケジュールタスク
      • テストシナリオを一括実行する
      • 他のプロジェクトのAPIの実行環境を管理する
      • テストシナリオを実行する
    • APIテスト
      • 統合テスト
      • 回帰テスト
      • エンドツーエンド(E2E)テスト
      • パフォーマンステスト
    • Apidog CLI
      • 概要
      • Apidog CLIのインストールと実行
      • Apidog CLI オプション
    • CI/CD
      • 概要
      • Jenkinsとの連携
      • Gitlabとの統合
  • APIドキュメント公開
    • 概要
    • Google AnalyticsとDoc Sitesの連携
    • CORS プロキシ
    • クイック共有
    • 可視性設定
    • ドキュメントURLに値を埋め込む
    • APIドキュメントを表示する
    • フォルダツリー設定
    • API SEO設定
    • カスタムレイアウト
    • ドキュメント検索
    • カスタムドメイン
    • ドキュメントサイトの公開
    • APIバージョン
      • 概要
      • APIバージョンの作成
      • APIバージョンの公開
      • APIバージョンごとにAPIの共有
  • リクエスト送信
    • 概要
    • GraphQL
    • gRPC
    • WebSocket
    • SSEデバッグ
    • SOAP/Webサービス
    • デバッグ用のリクエストプロキシエージェントを使用する
    • Socket.IO
    • リクエスト作成
      • リクエストの基本
      • パラメータとボディ
      • リクエストヘッダー
      • リクエスト設定
      • HTTP/2
      • リクエスト履歴
    • 認証と認可
      • 概要
      • CAとクライアント証明書
      • Apidogがサポートする認可タイプ
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Hawk Authentication
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • レスポンスとクッキー
      • 概要
      • ApidogのAPIレスポンス
      • Cookieの作成と送信
      • リクエストのデバッグ
      • リクエストをAPIとして保存
  • ブランチ管理
    • 概要
    • 新しいスプリントブランチの作成
    • スプリントブランチの管理
    • ブランチ内でのAPIテスト
    • ブランチでAPIの設計
    • スプリントブランチのマージ
  • Apidog MCP Server
    • 概要
    • Apidogプロジェクト内のAPI仕様をApidog MCPサーバー経由でAIに接続する
    • Apidogが公開したオンラインAPIドキュメントをApidog MCPサーバー経由でAIに接続する
    • Apidog MCPサーバーを介してOpenAPIファイルをAIに接続する
  • ベストプラクティス
    • ガイド:ChatGPT APIのトークンとコスト計算
    • Apidog コラボレーションワークフロー
    • API署名の取り扱い方法
    • Apidogでの認証状態の管理
    • OAuth 2.0で保護されたAPIにアクセスする方法
  • 管理
    • オンボーディングチェックリスト
      • 基本概念
      • Apidogスタートアップガイド
    • チーム管理
      • チーム管理
      • チームメンバーの管理
      • メンバーの役割と権限設定
      • チーム活動
      • チームリソース
        • 一般ランナー
        • チーム変数
        • リクエストプロキシエージェント
        • データベース接続
      • リアルタイムコラボレーション
        • チームコラボレーション
    • プロジェクト管理
      • プロジェクト管理
      • プロジェクトメンバーの管理
      • 通知設定
    • 組織管理
      • シングルサインオン(SSO)
        • 概要
        • Microsoft Entra IDの設定
        • Okta設定
        • 組織のSSOを設定する
        • チームへのグループのマッピング
        • ユーザーアカウントの管理
      • SCIMプロビジョニング
        • SCIMプロビジョニング入門
        • Microsoft Entra ID
        • Okta
      • 組織リソース
        • セルフホストランナー
  • 請求情報
    • 概要
    • プランのアップグレード
    • クレジット
    • クレジットカードが使えない?
    • サブスクリプションの管理
  • データ & セキュリティ
    • Apidogのデータはどこに保存され、データセキュリティはどのように確保されていますか?
    • ユーザーデータはどのように保存されますか?このデータは公開されますか?それともプライベートですか?すべてのデータはクラウドに保存されますか?
    • リクエストを送信する際、Apidogサーバーを経由しますか?データセキュリティは確保されていますか?
  • アドオン
    • API Hub
    • Apidog IntelliJ IDEA プラグイン
    • リクエストプロキシ
      • Apidogウェブでのリクエストプロキシ
      • 共有ドキュメントでのリクエストプロキシ
      • Apidogクライアントでのリクエストプロキシ
    • ブラウザ拡張機能
      • Microsoft Edge
      • Chrome
  • アカウント & 設定
    • アカウント設定
    • 言語設定
    • データバックアップ
    • ネットワークプロキシ設定
    • ホットキー
    • Apidogの更新
    • OpenAPIアクセストークンの生成
    • アカウント削除
  • 参考資料
    • Swagger拡張機能
    • Socket通信:パケットの分断と結合
    • 用語の説明
    • よくある質問
    • API-デザインファーストアプローチ
    • Apidog OpenAPI/Swagger仕様拡張
    • JSONPath
    • XPath
    • 正規表現
    • JSONスキーマ
    • CSVファイルフォーマット
    • Java環境のインストール
    • ランナーのデプロイ環境
    • ApidogフレーバーMarkdown
  1. Apidog CLI

Apidog CLI オプション

Apidog CLI の基本構文#

オンライン実行:
apidog run --access-token <value> [options]
Apidogのアクセストークンと特定のテストシナリオまたはテストシナリオディレクトリのIDを使用します。例:
apidog run --access-token $APIDOG_ACCESS_TOKEN -t 637132 -e 358171 -d 3497013 -r html,cli --database-connection ./database-connections.json
ローカル実行:
apidog run <collection> [options]
ApidogテストシナリオのURLまたはファイルパスを指定します。例:
apidog run examples/sample.apidog-cli.json -r cli,html

オプション#

オプション説明
--access-token <accessToken>オンライン実行用の認証トークンを設定
-t, --test-scenario <testScenarioId>実行するテストシナリオIDを指定
-f, --test-scenario-folder <folderId>実行するテストシナリオディレクトリIDを指定
-r, --reporters [reporters]テストレポートの種類を指定(デフォルト: ["cli"])
--out-dir <outDir>テストレポートの出力ディレクトリ(デフォルト: "./apidog-reports")
--out-file <outFile>テストレポートの出力ファイル名
--out-json-failures-separated <outJsonFailuresSeparated>失敗を別のJSONファイルとしてエクスポート
-e, --environment実行環境を指定
-n, --iteration-count <n>繰り返し回数を設定
-d, --iteration-data <path>ケース繰り返し用のデータを設定(JSONまたはCSV)
--variables <path>指定されたパスのファイルから環境/グローバル変数を使用し、環境/グローバル変数の初期値を使用しない。
--global-var <value>グローバル変数を設定(key=value形式)
--env-var <value>環境変数を設定(key=value形式)
--external-program-path <path>外部プログラムのファイルパスを指定
--database-connection <path>データベース設定のファイルパスを指定
--ignore-redirects自動リダイレクトを防止
--silentコンソール出力を防止
--color <value>カラーコンソール出力を有効/無効
--delay-request [n]リクエスト間の遅延を指定(ms)
--timeout-request [n]リクエストタイムアウトを指定(ms)
--timeout-script [n]スクリプト実行タイムアウトを指定(ms)
-k, --insecureSSL検証を無効
--ssl-client-cert-list <path>クライアント証明書設定ファイルのパスを指定
--ssl-client-cert <path>クライアント証明書のパスを指定(PEM)
--ssl-client-key <path>クライアント証明書の秘密鍵パスを指定
--ssl-client-passphrase <passphrase>クライアント証明書のパスフレーズを指定
--ssl-extra-ca-certs <path>追加の信頼できるCA証明書を指定
-b, --bigintbigint互換性を有効
--upload-report [value]テストレポートの概要をクラウドにアップロード
--preferred-http-version <preferredHttpVersion>優先HTTPプロトコルバージョンを設定
--verbose詳細なリクエストとレスポンス情報を表示
--lang <language>CLIの言語を設定(en)
-h, --helpヘルプ情報を表示

CLIでのファイルアップロード#

ファイルアップロードが必要なAPIを扱う場合、Apidogはローカルファイルのパスしか保存せず、実際のファイルはローカルコンピュータに残ることに注意が必要です。これにより、別のマシンでCLI経由でテストを実行する際に、保存されたパスを使用してファイルにアクセスできない問題が発生する可能性があります。
この問題を解決するには、以下の手順に従ってください:
1
必要なファイルを事前にCLIを実行するマシンにコピーします。
2
CLIマシン上のファイルパスをコピーします。
3
Apidogのテストシナリオで、ファイルアップロードリクエストのステップ詳細を開き、「一括編集」ボタンをクリックします。
4
ファイルフィールドのパラメータ値をCLIマシン上のファイルパスに置き換えます。
この設定後、ファイルはCLI経由でApidogに正しく送信されます。
注意:このテストシナリオを再度ローカルで実行する場合、パラメータ値のファイルパスをローカルマシン上のパスに戻す必要があります。

CLIでのデータベース操作の使用#

テストシナリオにデータベース操作が含まれている場合、データベース設定はローカルに保存され、クラウドには保存されないため、いくつかの追加手順が必要です。これにより、これらのシナリオに対して直接クラウドモードでCLIを実行することはできません。この状況を処理する方法は以下の通りです:
1
データベース操作を含むテストシナリオの場合、コマンドライン生成インターフェースに「データベース設定ファイルをダウンロード」というプロンプトが表示されます。
2
このファイルをダウンロードし、Apidog CLIを実行する予定のディレクトリに配置します。
3
自動生成されたコマンドラインには--database-connectionオプションが含まれます。このコマンドラインをそのまま使用してテストを実行できます。

ローカルCLIテストレポートをクラウドにアップロード#

ローカルCLIテストレポートをクラウドにアップロードするには、CLIコマンドの最後に--upload-reportパラメータを追加します。以下はその方法です:
1
CLIコマンドに--upload-reportパラメータを追加します:
apidog run --access-token $APIDOG_ACCESS_TOKEN -t 637132 -e 358171 -d 3497013 -r html,cli --upload-report
2
このコマンドはテストを実行し、完了後にテストレポートを自動的にクラウドにアップロードします。
3
アップロードされたレポートを表示するには:
Apidogダッシュボードの「テストレポート」セクションに移動します。
「チームレポート」列を探します。
4
注意:CLI経由でアップロードされたレポートの場合、「テスター」フィールドは空として表示されます。

CLIでの外部スクリプト/プログラムの使用#

Apidog CLIを実行する際に、外部スクリプトやプログラムを参照するために、コマンドの最後にそのパスを追加できます。以下はその方法です:
--external-program-path ./scripts
この例では、CLIに./scriptsディレクトリにあるプログラムを参照するように指示しています。階層が指定されていない場合、デフォルトは現在のCLI実行ディレクトリです。
これらの外部スクリプトを管理する主なアプローチは2つあります:
1.
ローカルパス
ローカルスクリプトの管理における混乱を避けるために、以下のことを推奨します:
すべてのスクリプトファイルをカテゴリ別に整理します。
特定のディレクトリに配置します。
CLIコマンドに対応するローカルパスを指定します。
2.
クラウドコードリポジトリ
または、以下のこともできます:
スクリプトファイルをクラウドベースのコードリポジトリにホストします。
CI/CDワークフローにプルコマンドを設定し、外部スクリプトをローカル環境にフェッチします。
CLIコマンドで外部スクリプトの実際のパスを指定します。

SSL#

クライアント証明書#

Apidog CLIはクライアント証明書の受け渡しをサポートしています。

単一のSSLクライアント証明書の使用#

--ssl-client-cert
SSLクライアント証明書の公開鍵のパスを指定します。
--ssl-client-key
SSLクライアント証明書の秘密鍵のパスを指定します(オプション)。
--ssl-client-passphrase
SSLクライアントのパスフレーズを指定します(オプション)。

SSLクライアント証明書設定ファイルの使用(複数証明書対応)#

--ssl-client-cert-list
SSLクライアント証明書リストのJSONファイルのパスを指定します。例:ssl-client-cert-list.json
このオプションは、URLまたはホスト名に基づいて異なるSSLクライアント証明書を設定することをサポートします。これは--ssl-client-cert、--ssl-client-key、--ssl-client-passphraseオプションよりも優先されます。リスト内のURLに一致するものがない場合、これらのオプションがフォールバックオプションとして使用されます。

HTTP/2#

CLIは、--preferred-http-versionパラメータを使用して、リクエストを送信するための特定のプロトコルバージョンを使用するように設定できます。
プロトコルバージョンパラメータ値:
1.
"HTTP/2" - HTTP/2 Application-Layer Protocol Negotiation (ALPN)、HTTPSリクエストのみサポート。
2.
"HTTP/2-with-prior-knowledge" - 事前知識付きHTTP/2
3.
"HTTP/1" - HTTP/1.1
このパラメータは以下の設定をサポートします:
1.
HTTPSとHTTPリクエストに対して異なるプロトコルバージョンを設定:
--preferred-http-version="https=HTTP/2,http=HTTP/2-with-prior-knowledge"
2.
HTTPSとHTTPに対して同じプロトコルバージョンを設定:
--preferred-http-version="HTTP/1"
3.
HTTPSとHTTPに対してHTTP/2を設定(サポートされていない値は自動的に無視されます):
--preferred-http-version="HTTP/2"

FAQ#

Q: Invalid character in header content["Authorization"]というエラーメッセージをどのように処理すればよいですか?
A: ApidogクライアントまたはWebインターフェースでテストシナリオを実行してもエラーが発生しないことを確認した場合、環境変数のINITIAL値が設定されているかどうかを確認してください。
Previous
Apidog CLIのインストールと実行
Next
概要
Built with