Tanto o CLI do Apidog quanto o CLI do Hoppscotch executam testes de API a partir de um terminal, e ambos se encaixam em um pipeline de CI/CD. No entanto, eles vêm de lugares diferentes. Hoppscotch é um ecossistema de API de código aberto, e seu CLI é um executor de coleções focado. Apidog é uma plataforma de API completa, e seu CLI é o ponto de entrada no terminal para um fluxo de trabalho maior de design-teste-mock-documentação.
Veredito rápido
- Escolha o CLI do Hoppscotch se código aberto e auto-hospedagem são o mais importante, você já usa Hoppscotch, e um relatório JUnit atende às suas necessidades de relatórios.
- Escolha o CLI do Apidog se você deseja relatórios em CLI, HTML e JSON, execuções orientadas a dados via CSV e JSON, relatórios hospedados na nuvem e uma plataforma integrada por trás do CLI.
Lado a lado
| CLI do Apidog | CLI do Hoppscotch | |
|---|---|---|
| Instalação | Apidog runner / CLI `apidog` | `npm i -g @hoppscotch/cli` (Node v22+) |
| Execuções | Cenários de teste e coleções | Coleções Hoppscotch |
| Fonte | Projeto Apidog, ou importação OpenAPI | Arquivo JSON de coleção ou ID de instância |
| Orientado a dados | `-d` CSV e JSON | `--iteration-data` CSV + `--iteration-count` |
| Geradores de relatório | CLI, HTML, JSON + upload para a nuvem | JUnit XML |
| Scripting | Pré/pós-processadores, asserções | Pré-requisição + `pw.test()` / `pw.expect()` |
| Linting de especificação | Sem linter autônomo (valida na importação) | Não (é um executor) |
| Recursos como código | Endpoints, esquemas, branches, pull requests | Não |
| Código aberto | Não (nível gratuito) | Sim, auto-hospedável |
| Plataforma mais ampla | Design, mock, documentação, teste em um único aplicativo | Parte do ecossistema Hoppscotch |
Instalação e execução
O CLI do Hoppscotch é instalado via npm e requer Node.js v22 ou mais recente (usuários do Node 20 devem permanecer no CLI v0.26.0):
npm i -g @hoppscotch/cli
hopp test ./collection.json -e ./staging.env.json
O CLI do Apidog vem através do Apidog runner e autentica com um login ou token de acesso, então executa cenários por ID:
apidog run -t <scenario-id> -e <env-id> --access-token <token>
Nenhuma das instalações é pesada. A única pegadinha é o requisito rígido do Node v22 do Hoppscotch, o que pode ser um problema para imagens de CI mais antigas. O guia de instalação do CLI do Apidog cobre a configuração do runner se você estiver começando do zero.
O que cada um executa
O CLI do Hoppscotch executa uma coleção Hoppscotch. Você pode passar um arquivo JSON de coleção local ou puxar um de uma instância Hoppscotch por ID com um token:
hopp test <collection-id> --token <access_token> --server https://hoppscotch.your-company.com
Para cada requisição, ele executa o script de pré-requisição, envia a requisição e avalia o script de teste com `pw.test()` e `pw.expect()`. Uma asserção falha produz um código de saída diferente de zero.
O CLI do Apidog executa cenários de teste construídos no seu projeto Apidog, que podem encadear etapas, compartilhar variáveis e fazer asserções em várias respostas. Como o CLI faz parte da plataforma, os mesmos cenários que você projeta e depura no aplicativo são os que você executa no CI; não há uma etapa de exportação separada. Consulte o guia completo do CLI do Apidog para o modelo de cenário e teste uma API REST da linha de comando para uma execução prática.
Testes orientados a dados
Ambas as ferramentas iteram um teste sobre um conjunto de dados, que é a característica que a maioria das equipes valoriza.
Hoppscotch usa dados de iteração CSV mais uma contagem:
hopp test ./collection.json --iteration-data ./users.csv --iteration-count 5
Apidog aceita conjuntos de dados CSV e JSON com `-d`:
apidog run -t <scenario-id> -d ./users.csv -r cli,html
A diferença prática é a flexibilidade de formato. Hoppscotch lê CSV; Apidog lê CSV e JSON, o que importa quando seus dados de teste são aninhados ou já existem como JSON. O guia de testes orientados a dados do CLI do Apidog mostra os padrões CSV e JSON lado a lado.
Relatórios
Esta é a divisão mais clara. O CLI do Hoppscotch gera XML JUnit:
hopp test ./collection.json --reporter-junit ./report.xml
JUnit é amplamente suportado, então a maioria dos sistemas de CI exibe os resultados nativamente. Mas é o único formato estruturado que o CLI produz.
O CLI do Apidog emite relatórios em CLI, HTML e JSON, e pode enviar os resultados para a nuvem para um link hospedado e compartilhável:
apidog run -t <scenario-id> -r cli,html,json
apidog run -t <scenario-id> --upload-report
Se você deseja um artefato HTML autocontido para um revisor de PR, ou um URL de relatório hospedado para compartilhar em um canal do Slack, Apidog abrange mais formatos. O guia de relatórios de teste do CLI do Apidog explica cada um. Se JUnit no seu painel de CI é tudo o que você precisa, Hoppscotch é adequado.
Código aberto e auto-hospedagem
Aqui, Hoppscotch ganha em seus próprios termos. Todo o ecossistema é de código aberto e auto-hospedável, então você pode executar o backend por conta própria e manter os dados de requisição fora de qualquer nuvem de fornecedor. Para equipes com regras rígidas de residência de dados ou preferência por ferramentas abertas, essa é uma razão real e defensável para escolhê-lo. A visão geral de alternativas ao Hoppscotch e Postman vs Hoppscotch cobrem o ecossistema mais amplo.
Apidog não é de código aberto. Ele possui um nível gratuito, e sua proposta não é ser “mais aberto”; é ser “mais integrado”.
Além da execução de testes
É aqui que o CLI do Apidog deixa de ser apenas um executor. Ele gerencia recursos de API como código: importando OpenAPI, e trabalhando com endpoints, esquemas, ambientes, branches e pull requests a partir do terminal. Isso faz do CLI parte de um fluxo de trabalho estilo Git, em vez de um comando de teste único.
É também a interface de terminal de uma plataforma completa. O mesmo projeto impulsiona o design de API, servidores mock, documentação e testes. O CLI do Hoppscotch, por design, executa coleções e nada mais; você traz design, mocking e documentação de outros lugares.
Nota de sinceridade: o CLI do Apidog não possui um linter OpenAPI autônomo ou comando de guia de estilo. Ele valida as especificações na importação, mas não as 'linta' da mesma forma que um linter dedicado. Se o linting de especificação no terminal é um requisito rígido, nenhum desses executores é o seu linter; uma ferramenta como Redocly CLI ou Spectral é. Compare as compensações dos executores em CLI do Apidog vs Newman.
Quem deve escolher qual
- Desenvolvedor solo ou equipe que prioriza código aberto, já usando Hoppscotch: o CLI do Hoppscotch. Gratuito, auto-hospedável, JUnit no CI, pronto.
- Equipe que deseja uma plataforma única para design, mock, documentação e teste, com execuções orientadas a dados via CSV/JSON e relatórios HTML/JSON/nuvem: o CLI do Apidog. Baixe o Apidog e importe uma coleção existente para experimentá-lo.
- Precisa apenas de uma execução rápida de coleção no CI sem outras necessidades: ambos funcionam; escolha com base no aplicativo onde suas coleções já residem.
Perguntas Frequentes
Ambos suportam testes orientados a dados? Sim. Hoppscotch usa `--iteration-data` (CSV) com `--iteration-count`; Apidog usa `-d` com CSV ou JSON.
Qual tem melhores relatórios? Hoppscotch gera XML JUnit. Apidog gera CLI, HTML e JSON, além de relatórios hospedados na nuvem. Se você precisa de mais do que JUnit, Apidog abrange mais formatos.
O CLI do Hoppscotch é gratuito e de código aberto? Sim, e é auto-hospedável. A documentação oficial e o repositório do GitHub contêm os detalhes. Apidog tem um nível gratuito, mas não é de código aberto.
Posso mover minhas coleções Hoppscotch para o Apidog? Sim. Exporte a coleção e importe-a, depois execute com `apidog run`. O guia de migração cobre o mapeamento de comandos.
Ambos os executores realizam bem o trabalho principal. Escolha o CLI do Hoppscotch para código aberto e auto-hospedagem; escolha o Apidog quando você deseja que o executor seja uma parte de uma plataforma de API integrada com execuções e relatórios orientados a dados mais ricos.