Apidog CLIとHoppscotch CLIはどちらもターミナルからAPIテストを実行し、CI/CDパイプラインに組み込むことができます。しかし、それぞれ異なる出自を持っています。HoppscotchはオープンソースのAPIエコシステムであり、そのCLIは特化したコレクションランナーです。一方、ApidogはオールインワンのAPIプラットフォームであり、そのCLIはより大規模なデザイン-テスト-モック-ドキュメントのワークフローへのターミナルからの入り口となります。
簡単な判断
- オープンソースとセルフホスティングが最も重要で、すでにHoppscotchを使用しており、JUnitレポートでレポートのニーズが満たされる場合は、Hoppscotch CLIを選択してください。
- CLI、HTML、JSONレポート、CSVとJSONによるデータ駆動型実行、クラウドホスト型レポート、そしてCLIの背後にある統合プラットフォームが必要な場合は、Apidog CLIを選択してください。
比較
| Apidog CLI | Hoppscotch CLI | |
|---|---|---|
| インストール | Apidog runner / apidog CLI |
npm i -g @hoppscotch/cli (Node v22以降) |
| 実行対象 | テストシナリオとコレクション | Hoppscotchコレクション |
| ソース | Apidogプロジェクト、またはOpenAPIインポート | コレクションJSONファイル、またはインスタンスID |
| データ駆動型 | -d CSVおよびJSON |
--iteration-data CSV + --iteration-count |
| レポーター | CLI、HTML、JSON + クラウドアップロード | JUnit XML |
| スクリプト | プリ/ポストプロセッサー、アサーション | プリリクエスト + pw.test() / pw.expect() |
| 仕様リンティング | スタンドアロンリンターなし(インポート時に検証) | なし(ランナーのため) |
| コードとしてのリソース | エンドポイント、スキーマ、ブランチ、マージリクエスト | なし |
| オープンソース | なし(フリーティアあり) | はい、セルフホスト可能 |
| 広範なプラットフォーム | 設計、モック、ドキュメント、テストが1つのアプリで | Hoppscotchエコシステムの一部 |
インストールと実行
Hoppscotch CLIはnpmからインストールされ、Node.js v22以降が必要です(Node 20ユーザーはCLI v0.26.0を使用):
npm i -g @hoppscotch/cli
hopp test ./collection.json -e ./staging.env.json
Apidog CLIはApidog runnerを介して提供され、ログインまたはアクセストークンで認証した後、IDでシナリオを実行します:
apidog run -t <scenario-id> -e <env-id> --access-token <token>
どちらのインストールも重くありません。唯一の注意点は、Hoppscotchの厳格なNode v22要件で、古いCIイメージでは問題になることがあります。Apidog CLIインストールガイドには、新規に開始する場合のランナーセットアップが記載されています。
それぞれの実行内容
Hoppscotch CLIはHoppscotchコレクションを実行します。ローカルのコレクションJSONファイルを渡すか、トークンを使ってHoppscotchインスタンスからIDでプルします:
hopp test <collection-id> --token <access_token> --server https://hoppscotch.your-company.com
各リクエストに対して、プリリクエストスクリプトを実行し、リクエストを送信し、pw.test()とpw.expect()でテストスクリプトを評価します。アサーションが失敗すると、ゼロ以外の終了コードが生成されます。
Apidog CLIは、Apidogプロジェクトで構築されたテストシナリオを実行します。これにより、ステップを連結し、変数を共有し、応答間でアサーションを行うことができます。CLIはプラットフォームの一部であるため、アプリで設計およびデバッグするのと同じシナリオをCIで実行できます。個別のエクスポートステップはありません。シナリオモデルについてはApidog CLI完全ガイドを、実際に実行する方法についてはコマンドラインからREST APIをテストするを参照してください。
データ駆動型テスト
どちらのツールもデータセットに対してテストを繰り返し実行する機能を備えており、これはほとんどのチームが重視する機能です。
HoppscotchはCSV反復データとカウントを使用します:
hopp test ./collection.json --iteration-data ./users.csv --iteration-count 5
Apidogは-dでCSVとJSONのデータセットを受け入れます:
apidog run -t <scenario-id> -d ./users.csv -r cli,html
実用的な違いはフォーマットの柔軟性です。HoppscotchはCSVを読み取ります。ApidogはCSVとJSONを読み取りますが、これはフィクスチャがネストされている場合や、すでにJSONとして存在している場合に重要です。Apidog CLIデータ駆動型テストガイドでは、CSVとJSONのパターンが並べて示されています。
レポート
ここは最も明確な違いがあります。Hoppscotch CLIはJUnit XMLを生成します:
hopp test ./collection.json --reporter-junit ./report.xml
JUnitは広くサポートされているため、ほとんどのCIシステムで結果がネイティブに表示されます。しかし、これはCLIが生成する唯一の構造化されたフォーマットです。
Apidog CLIはCLI、HTML、JSONレポートを出力し、結果をクラウドにプッシュしてホストされた共有可能なリンクを作成できます:
apidog run -t <scenario-id> -r cli,html,json
apidog run -t <scenario-id> --upload-report
PRレビューア用の自己完結型HTMLアーティファクトが必要な場合や、SlackチャネルにドロップするホストされたレポートURLが必要な場合、Apidogはより多くのフォーマットをカバーします。Apidog CLIテストレポートガイドでそれぞれを詳しく解説しています。CIダッシュボードへのJUnitだけで十分な場合は、Hoppscotchで問題ありません。
オープンソースとセルフホスティング
ここではHoppscotchがその強みを発揮します。エコシステム全体がオープンソースであり、セルフホスト可能であるため、自分でバックエンドを実行し、リクエストデータをベンダーのクラウドから分離することができます。厳格なデータレジデンシー規則を持つチームや、オープンなツールを好むチームにとって、これは選択する正当な理由となります。Hoppscotchの代替品のまとめやPostman vs Hoppscotchでは、より広範なエコシステムを扱っています。
Apidogはオープンソースではありません。フリーティアはありますが、「よりオープン」を謳っているわけではなく、「より統合されている」ことを強調しています。
テスト実行を超えて
Apidog CLIが単なるランナーではなくなるのはここです。これは、APIリソースをコードとして管理します。OpenAPIのインポート、エンドポイント、スキーマ、環境、ブランチ、マージリクエストのターミナルからの操作が可能です。これにより、CLIは単発のテストコマンドではなく、Gitスタイルのワークフローの一部となります。
また、これはフルプラットフォームのターミナルインターフェースでもあります。同じプロジェクトがAPI設計、モックサーバー、ドキュメント、テストを駆動します。Hoppscotch CLIは、設計上、コレクションを実行するだけで、それ以上は行いません。設計、モック、ドキュメントは他の場所から持ち込む必要があります。
正直な注意: Apidog CLIにはスタンドアロンのOpenAPIリンターやスタイルガイドコマンドはありません。インポート時に仕様を検証しますが、専用のリンターのようにリンティングはしません。ターミナルでの仕様リンティングが必須要件である場合、これらのランナーはどちらもリンターではありません。Redocly CLIやSpectralのようなツールが必要です。Apidog CLI vs Newmanでランナーのトレードオフを比較してください。
どちらを選ぶべきか
- Hoppscotchをすでに利用している、単独の開発者またはオープンソース優先のチーム: Hoppscotch CLI。無料でセルフホスト可能、JUnitをCIに統合、これで完了です。
- 設計、モック、ドキュメント、テストのための単一プラットフォームを望み、CSV/JSONを介したデータ駆動型実行、HTML/JSON/クラウドレポートが必要なチーム:Apidog CLI。Apidogをダウンロードして既存のコレクションをインポートし、試してみてください。
- CIでコレクションを迅速に実行するだけで、その他のニーズがない場合: どちらも機能します。コレクションがすでに存在するアプリで選択してください。
よくある質問
どちらもデータ駆動型テストをサポートしていますか? はい。Hoppscotchは--iteration-data (CSV) と--iteration-countを使用し、ApidogはCSVまたはJSONで-dを使用します。
どちらのレポートが優れていますか? HoppscotchはJUnit XMLを生成します。ApidogはCLI、HTML、JSON、さらにホストされたクラウドレポートを生成します。JUnit以上のものが必要な場合は、Apidogがより多くのフォーマットをカバーします。
Hoppscotch CLIは無料でオープンソースですか? はい、そしてセルフホスト可能です。公式ドキュメントとGitHubリポジトリに詳細が記載されています。Apidogにはフリーティアがありますが、オープンソースではありません。
HoppscotchコレクションをApidogに移行できますか? はい。コレクションをエクスポートしてインポートし、apidog runで実行します。移行ガイドにはコマンドマッピングが記載されています。
どちらのランナーもコアとなる作業をうまくこなします。オープンソースとセルフホスティングを重視する場合はHoppscotch CLIを、より豊富なデータ駆動型実行とレポート機能を備えた統合APIプラットフォームの一部としてランナーを使用したい場合はApidogを選択してください。
