Melhores Ferramentas CLI Leves para Mock de API

Você precisa de uma API falsa para desenvolver e precisa dela nos próximos trinta segundos. Não um serviço hospedado, não uma pilha Docker Compose, nem uma GUI para clicar. Apenas um comando que lê um arquivo e começa a fornecer respostas no localhost.

É isso que um servidor de mock leve faz. Você o aponta para uma especificação OpenAPI ou um pequeno arquivo de dados, executa um comando e obtém endpoints realistas que seu frontend ou testes podem acessar enquanto o backend real ainda está sendo construído. Os melhores vêm como um único binário ou um pacote `npx`-ável, iniciam em menos de um segundo e precisam de quase nenhuma configuração. Algumas das opções mais pesadas aqui rodam na JVM e fazem muito mais; elas ganham seu lugar quando você precisa de correspondência de requisição avançada ou comportamento com estado.

Este guia classifica seis mockers CLI pela pouca exigência que fazem de você. Começa com aqueles que você pode executar sem instalar nada, depois aborda os servidores JVM autônomos e termina com a rota integrada através da CLI do Apidog. Cada comando de instalação e mock abaixo foi verificado em relação à documentação oficial de cada ferramenta. Se você quiser o campo mais amplo além da linha de comando, a compilação das melhores ferramentas de mock de API também abrange opções GUI e hospedadas.

O que torna uma ferramenta de mock CLI “leve”

Leveza se refere a pegada e atrito, não à contagem de recursos. Ao comparar essas ferramentas, considere quatro coisas:

• Tamanho da instalação e tempo de execução. Um pacote Node puro que você pode `npx` pesa alguns megabytes. Um servidor JVM autônomo é um jar de mais de 20MB que precisa de um ambiente de execução Java. Ambos são válidos; eles estão em extremidades diferentes desta lista.
• Velocidade de inicialização. Um bom servidor de mock está funcionando antes que você volte para o seu editor. Ferramentas baseadas em Node iniciam em bem menos de um segundo.
• Configuração para a primeira resposta. Você consegue ir do zero a um endpoint ativo com um arquivo e um comando? As ferramentas mais leves dizem que sim.
• Primeiro o terminal. Sem conta, sem dashboard, sem etapa GUI no processo. A ferramenta lê um arquivo e o serve, e cabe em um script shell ou job de CI.

As ferramentas são ordenadas da menor e mais rápida primeiro. Prism, Mockoon CLI e json-server são as que você pode executar com `npx` e sem instalação global.

Prism (Stoplight)

Prism transforma um arquivo OpenAPI em um servidor de mock ativo com um único comando. Se você já tem uma especificação, este é o mock de menor esforço na lista; ele lê seus `paths`, `examples` e schemas e serve respostas que os correspondem.

npx @stoplight/prism-cli mock ./openapi.yaml

Isso inicia um servidor em `http://127.0.0.1:4010` com cada operação da sua especificação configurada. O Prism retorna o `example` que você definiu para uma resposta, ou gera um válido aleatório a partir do schema, caso você não tenha definido um. Ele também valida as requisições de entrada em relação à especificação, para que uma chamada malformada receba um `422` adequado em vez de uma passagem silenciosa. Para uma instalação global, use `npm install -g @stoplight/prism-cli` e dispense o `npx`.

Melhor para: equipes que priorizam a especificação e querem que o mock seja fiel ao contrato. O Prism é licenciado sob Apache-2.0 e suporta OpenAPI 3.1, 3.0, 2.0 e coleções Postman.

Limitações honestas: O Prism é sem estado (stateless). Um `POST` não persiste nada, então ele não simulará um fluxo de criar e depois ler. Seu mock é tão bom quanto sua especificação; exemplos escassos significam respostas escassas. Para mocking preciso em relação ao contrato, esse é exatamente o objetivo, e ele se encaixa bem com o fluxo de trabalho das ferramentas de mocking de API REST.

Mockoon CLI

Mockoon CLI executa uma API de mock a partir de um arquivo de dados, seja um que você exportou do aplicativo desktop gratuito Mockoon ou uma especificação OpenAPI simples. O aplicativo desktop permite que você construa rotas visualmente; a CLI executa esse mesmo ambiente sem interface (headless) em CI ou em um servidor.

npx @mockoon/cli start --data ./mockoon-env.json --port 3000

Aponte `--data` para um arquivo de ambiente Mockoon ou um arquivo OpenAPI JSON/YAML e ele servirá imediatamente. Se o arquivo de dados veio de uma versão mais antiga do Mockoon, a CLI o migra em memória sem alterar o original. Instale-o globalmente com `npm install -g @mockoon/cli` se preferir um comando `mockoon-cli` persistente.

Melhor para: equipes que querem projetar mocks em uma GUI, mas executá-los sem interface. É licenciado sob MIT e possui uma imagem Docker oficial para implantações.

Limitações honestas: as rotas mais ricas são construídas no aplicativo desktop, então editar manualmente o arquivo de ambiente JSON é trabalhoso. Se você não quiser nenhum aplicativo complementar, Prism ou json-server mantêm tudo em um único arquivo que você escreve manualmente.

json-server

json-server é a maneira mais rápida de simular uma API REST quando você ainda não tem uma especificação. Você escreve um arquivo JSON simples descrevendo seus dados, e ele gera uma API REST completa em torno disso, com `GET`, `POST`, `PUT`, `PATCH` e `DELETE`.

echo '{ "posts": [{ "id": 1, "title": "hello" }] }' > db.json
npx json-server db.json

Isso serve `http://localhost:3000/posts` com CRUD real. Um `POST` para `/posts` realmente adiciona um registro e o grava de volta em `db.json`, então você obtém comportamento com estado gratuitamente, o que Prism e WireMock não oferecerão de imediato. Você também obtém filtragem, classificação e paginação via parâmetros de consulta. A linha 1.x atual monitora o arquivo e recarrega na mudança por padrão; instale globalmente com `npm install -g json-server` se quiser que ele esteja sempre no seu `PATH`.

Melhor para: desenvolvedores frontend que precisam de um backend REST funcionando em um minuto, antes que a API real exista. É licenciado sob MIT e uma das opções de servidor de mock leve para uma API RESTful que não precisa de nenhuma especificação.

Limitações honestas: ele assume um formato REST estilo recurso. Rotas altamente personalizadas, endpoints não-REST ou correspondência rigorosa de cabeçalhos estão fora do que ele faz de forma limpa. É uma ferramenta de prototipagem, não um validador de contrato.

MockServer

MockServer é o "peso-pesado" para correspondência precisa de requisições. Onde as ferramentas acima servem uma especificação ou um arquivo de dados, o MockServer permite que você defina expectativas: corresponda uma requisição por método, caminho, cabeçalho, query ou corpo, e então retorne exatamente a resposta que você deseja, incluindo atrasos e falhas para testar timeouts e tratamento de erros.

java -jar mockserver-netty-5.15.0-no-dependencies.jar -p 1080

Isso inicia o MockServer na porta `1080`. Você então envia expectativas para sua API REST para configurar o comportamento, ou o controla programaticamente. Usuários Node podem pular o jar bruto e usar o wrapper oficial:

npm install mockserver-node

const mockserver = require('mockserver-node');
mockserver.start_mockserver({ serverPort: 1080 });

Melhor para: testes de integração que precisam de controle granular sobre como uma requisição deve se parecer e como o mock responde. É licenciado sob Apache-2.0 e suporta HTTP, HTTPS e mais em uma única porta.

Limitações honestas: é um servidor JVM, então é mais pesado e lento para iniciar do que as ferramentas Node, e a configuração de expectativas é mais verbosa do que simplesmente apontar para uma especificação. Se você só precisa de uma especificação servida, isso é um exagero; se você precisar de mais, a comparação de alternativas ao MockServer expõe as compensações.

WireMock (autônomo)

WireMock é o outro servidor de mock JVM estabelecido, popular no mundo de testes Java e JVM. Seu jar autônomo executa o mesmo motor que você incorporaria em um teste JUnit, então um mock que você constrói no desenvolvimento local se estende diretamente para sua suíte de testes.

java -jar wiremock-standalone.jar --port 8080

Isso serve na porta `8080`. O WireMock lê mapeamentos de stub de um diretório `mappings/` ou de sua API JSON, e também pode gravar tráfego real e reproduzi-lo como stubs, o que é útil ao simular uma API de terceiros que você não controla. Existe uma imagem Docker oficial `wiremock/wiremock` para CI.

Melhor para: equipes JVM que desejam um único motor de mocking compartilhado entre o desenvolvimento local e sua suíte de testes, além de gravação e reprodução. É licenciado sob Apache-2.0.

Limitações honestas: assim como o MockServer, ele precisa de um ambiente de execução Java e inicia mais lentamente do que as opções Node. Seu JSON de mapeamento de stub é poderoso, mas há mais para aprender do que um mock de dados de um único arquivo. Se você veio do lado JavaScript, a comparação de alternativas ao Mock Service Worker (MSW) aborda onde o WireMock se encaixa em relação ao mocking focado no navegador.

Apidog CLI

As ferramentas acima resolvem cada uma uma fatia do mocking. O Apidog adota a rota integrada: seu design de API, o mock, seus testes e sua documentação vivem em um único projeto, e a Apidog CLI gerencia esse projeto a partir do terminal. O Apidog não é de código aberto; é um produto comercial com um nível gratuito. Mas esse nível gratuito, mais a CLI, oferece uma alternativa a unir um servidor de mock, um executor de testes e uma ferramenta de especificação separados.

O Apidog gera um mock inteligente automaticamente a partir de cada endpoint que você define, com respostas que seguem os tipos de campo e a nomenclatura do seu esquema, de modo que um campo `phone` retorna um número de telefone plausível em vez de uma string aleatória. Quando você precisa de uma resposta específica para uma requisição específica, você adiciona uma expectativa de mock. A CLI gerencia esses recursos de mock como parte do projeto:

npm install -g apidog-cli
apidog login --with-token <YOUR_TOKEN>
apidog mock --help

O grupo de comandos `mock` funciona com as expectativas de mock do seu projeto a partir de scripts e CI, juntamente com grupos de comandos para endpoints, schemas, ambientes e execuções de teste. A saída é JSON estruturado com um campo `agentHints.nextSteps`, o que o torna utilizável por agentes de IA, bem como por humanos. A superfície completa de comandos é abordada no guia completo da Apidog CLI.

Melhor para: equipes que preferem manter o mock, a especificação e os testes em um só lugar em vez de executar três ferramentas separadas. Baixe o Apidog para experimentar o servidor de mock integrado e a CLI em seu próprio projeto.

Limitações honestas: é uma plataforma, não um binário de propósito único, então ele pede um projeto e um login onde o json-server não pede nada. Se tudo o que você precisa é um mock descartável de um único arquivo, uma ferramenta mais leve vence; se você já está projetando sua API no Apidog, o mock já está lá.

Como escolher

Combine a ferramenta com o que você já tem. Se você possui uma especificação OpenAPI, Prism ou Mockoon CLI a servem diretamente. Se você ainda não tem nada, json-server inventa uma API a partir de um arquivo JSON. Se você precisa de correspondência exata de requisições, use MockServer ou WireMock. Se você quer que o mock viva ao lado do seu design e testes, use Apidog.

A regra geral: ferramentas `npx` para velocidade, servidores JVM para profundidade de correspondência, Apidog quando você quer um único fluxo de trabalho em vez de vários. Se você ainda está decidindo se deve usar mocks, o passo a passo dos casos de uso de mocking de API aborda quando vale a pena.

Conclusão

O mocking leve se resume a uma pergunta: o que você já tem para alimentar a ferramenta? Uma especificação vai para Prism ou Mockoon CLI. Um projeto em branco vai para json-server. Correspondência rigorosa vai para MockServer ou WireMock. E se você preferir não executar e configurar várias ferramentas, o Apidog mantém o mock ao lado do design e dos testes, impulsionado pela mesma CLI que você usaria de qualquer maneira.

Todos os seis são executados a partir do terminal, cabem em um trabalho de CI e fornecem uma API falsa em segundos, em vez de horas. Escolha o menor que atenda ao seu caso e adicione peso apenas quando realmente precisar. Para ver a versão integrada, Baixe o Apidog e gere um servidor de mock a partir do seu design de API em uma única etapa.