Les CLI Apidog et Hoppscotch exécutent toutes deux des tests d'API depuis un terminal, et s'intègrent toutes deux dans un pipeline CI/CD. Elles proviennent cependant d'endroits différents. Hoppscotch est un écosystème d'API open source, et sa CLI est un exécuteur de collections ciblé. Apidog est une plateforme d'API tout-en-un, et sa CLI est le point d'entrée terminal d'un flux de travail plus vaste de conception, de test, de maquettage et de documentation.
Verdict rapide
- Choisissez la CLI Hoppscotch si l'open source et l'auto-hébergement sont les plus importants, si vous utilisez déjà Hoppscotch et qu'un rapport JUnit couvre vos besoins en matière de rapports.
- Choisissez la CLI Apidog si vous souhaitez des rapports CLI, HTML et JSON, des exécutions basées sur les données via CSV et JSON, des rapports hébergés dans le cloud et une plateforme intégrée derrière la CLI.
Comparaison côte à côte
| CLI Apidog | CLI Hoppscotch | |
|---|---|---|
| Installation | Exécuteur Apidog / apidog CLI |
npm i -g @hoppscotch/cli (Node v22+) |
| Exécute | Scénarios de test et collections | Collections Hoppscotch |
| Source | Projet Apidog, ou importation OpenAPI | Fichier JSON de collection ou ID d'instance |
| Basé sur les données | -d CSV et JSON |
--iteration-data CSV + --iteration-count |
| Rapporteurs | CLI, HTML, JSON + téléchargement cloud | XML JUnit |
| Scripting | Pré/post-processeurs, assertions | Pré-requête + pw.test() / pw.expect() |
| Linting des spécifications | Pas de linter autonome (valide à l'importation) | Non (c'est un exécuteur) |
| Ressources en tant que code | Points d'accès (Endpoints), schémas, branches, requêtes de fusion | Non |
| Open source | Non (niveau gratuit) | Oui, auto-hébergeable |
| Plateforme plus large | Conception, maquette, docs, test dans une seule application | Fait partie de l'écosystème Hoppscotch |
Installation et exécution
La CLI Hoppscotch s'installe depuis npm et nécessite Node.js v22 ou une version plus récente (les utilisateurs de Node 20 restent sur la CLI v0.26.0) :
npm i -g @hoppscotch/cli
hopp test ./collection.json -e ./staging.env.json
La CLI Apidog est fournie via l'exécuteur Apidog et s'authentifie avec un identifiant ou un jeton d'accès, puis exécute les scénarios par ID :
apidog run -t <scenario-id> -e <env-id> --access-token <token>
Aucune des deux installations n'est lourde. Le seul hic est l'exigence stricte de Node v22 pour Hoppscotch, ce qui peut poser problème sur les anciennes images CI. Le guide d'installation de la CLI Apidog couvre la configuration de l'exécuteur si vous partez de zéro.
Ce que chaque outil exécute
La CLI Hoppscotch exécute une collection Hoppscotch. Vous pouvez soit passer un fichier JSON de collection local, soit en récupérer un depuis une instance Hoppscotch par ID avec un jeton :
hopp test <collection-id> --token <access_token> --server https://hoppscotch.your-company.com
Pour chaque requête, elle exécute le script de pré-requête, envoie la requête et évalue le script de test avec pw.test() et pw.expect(). Une assertion échouée produit un code de sortie non nul.
La CLI Apidog exécute des scénarios de test créés dans votre projet Apidog, qui peuvent enchaîner des étapes, partager des variables et faire des assertions sur les réponses. Parce que la CLI fait partie de la plateforme, les mêmes scénarios que vous concevez et déboguez dans l'application sont ceux que vous exécutez en CI ; il n'y a pas d'étape d'exportation séparée. Consultez le guide complet de la CLI Apidog pour le modèle de scénario et testez une API REST depuis la ligne de commande pour une exécution pratique.
Tests basés sur les données
Les deux outils itèrent un test sur un ensemble de données, ce qui est la fonctionnalité la plus importante pour la plupart des équipes.
Hoppscotch utilise des données d'itération CSV plus un compteur :
hopp test ./collection.json --iteration-data ./users.csv --iteration-count 5
Apidog accepte les ensembles de données CSV et JSON avec -d :
apidog run -t <scenario-id> -d ./users.csv -r cli,html
La différence pratique réside dans la flexibilité du format. Hoppscotch lit le CSV ; Apidog lit le CSV et le JSON, ce qui est important lorsque vos fixtures sont imbriquées ou existent déjà en JSON. Le guide de test basé sur les données de la CLI Apidog présente les modèles CSV et JSON côte à côte.
Rapports
C'est la différence la plus nette. La CLI Hoppscotch génère du XML JUnit :
hopp test ./collection.json --reporter-junit ./report.xml
JUnit est largement pris en charge, de sorte que la plupart des systèmes CI affichent les résultats nativement. Mais c'est le seul format structuré que la CLI produit.
La CLI Apidog génère des rapports CLI, HTML et JSON, et peut envoyer les résultats vers le cloud pour un lien hébergé et partageable :
apidog run -t <scenario-id> -r cli,html,json
apidog run -t <scenario-id> --upload-report
Si vous souhaitez un artefact HTML autonome pour un relecteur de PR, ou une URL de rapport hébergée à partager dans un canal Slack, Apidog couvre plus de formats. Le guide des rapports de test de la CLI Apidog les explique un par un. Si JUnit dans votre tableau de bord CI est tout ce dont vous avez besoin, Hoppscotch convient.
Open source et auto-hébergement
Ici, Hoppscotch l'emporte selon ses propres termes. Tout l'écosystème est open source et auto-hébergeable, vous pouvez donc exécuter le backend vous-même et conserver les données de requête hors de tout cloud tiers. Pour les équipes ayant des règles strictes de résidence des données ou une préférence pour les outils ouverts, c'est une raison réelle et défendable de le choisir. Le tour d'horizon des alternatives à Hoppscotch et la comparaison Postman vs Hoppscotch couvrent l'écosystème plus large.
Apidog n'est pas open source. Il propose un niveau gratuit, et son argument n'est pas « plus ouvert » ; il est « plus intégré ».
Au-delà de l'exécution des tests
C'est là que la CLI Apidog cesse d'être un simple exécuteur. Elle gère les ressources API en tant que code : importation d'OpenAPI, et travail avec les points d'accès (endpoints), les schémas, les environnements, les branches et les requêtes de fusion (merge requests) depuis le terminal. Cela fait de la CLI une partie d'un flux de travail de style Git plutôt qu'une commande de test unique.
C'est aussi l'interface terminale d'une plateforme complète. Le même projet gère la conception d'API, les serveurs de maquettes, la documentation et les tests. La CLI Hoppscotch, par conception, exécute des collections et rien de plus ; la conception, la maquette et la documentation proviennent d'ailleurs.
Note d'honnêteté : la CLI Apidog ne dispose pas d'un linter OpenAPI autonome ni d'une commande de guide de style. Elle valide les spécifications lors de l'importation, mais ne les linte pas comme le ferait un linter dédié. Si le linting des spécifications en terminal est une exigence stricte, aucun de ces exécuteurs n'est votre linter ; un outil comme Redocly CLI ou Spectral l'est. Comparez les compromis des exécuteurs dans CLI Apidog vs Newman.
Qui devrait choisir quoi
- Développeur solo ou équipe privilégiant l'open source, déjà sur Hoppscotch : la CLI Hoppscotch. Gratuite, auto-hébergeable, JUnit en CI, le tour est joué.
- Équipe souhaitant une plateforme unique pour la conception, la maquette, la documentation et les tests, avec des exécutions basées sur les données via CSV/JSON et des rapports HTML/JSON/cloud : la CLI Apidog. Téléchargez Apidog et importez une collection existante pour l'essayer.
- Juste besoin d'une exécution rapide de collection en CI sans autres besoins : l'un ou l'autre fonctionne ; choisissez en fonction de l'application dans laquelle vos collections résident déjà.
FAQ
Les deux prennent-ils en charge les tests basés sur les données ? Oui. Hoppscotch utilise --iteration-data (CSV) avec --iteration-count ; Apidog utilise -d avec CSV ou JSON.
Lequel propose de meilleurs rapports ? Hoppscotch génère du XML JUnit. Apidog génère des rapports CLI, HTML et JSON, ainsi que des rapports cloud hébergés. Si vous avez besoin de plus que JUnit, Apidog couvre davantage de formats.
La CLI Hoppscotch est-elle gratuite et open source ? Oui, et elle est auto-hébergeable. La documentation officielle et le référentiel GitHub contiennent les détails. Apidog propose un niveau gratuit mais n'est pas open source.
Puis-je transférer mes collections Hoppscotch vers Apidog ? Oui. Exportez la collection et importez-la, puis exécutez-la avec apidog run. Le guide de migration couvre le mappage des commandes.
Les deux exécuteurs font bien le travail de base. Choisissez la CLI Hoppscotch pour l'open source et l'auto-hébergement ; choisissez Apidog lorsque vous souhaitez que l'exécuteur fasse partie d'une plateforme API intégrée avec des exécutions et des rapports plus riches basés sur les données.