O que é Mocky e a melhor alternativa ao Mocky para mocks HTTP personalizados

Se você já precisou de um endpoint de API falso que retornasse um corpo JSON, código de status e cabeçalhos específicos sem precisar configurar um servidor, provavelmente pesquisou por Mocky. Este guia explica o que é Mocky, como usá-lo e quando você o superará. Se você quiser ter uma visão mais ampla primeiro, nossa compilação de ferramentas de mocking de API online comparadas cobre o campo, e o próprio repositório de código aberto do Mocky confirma o básico.

O que é Mocky?

Mocky é um serviço web gratuito e de código aberto para gerar respostas HTTP personalizadas. Você projeta uma resposta em seu navegador, o Mocky lhe dá uma URL exclusiva e qualquer solicitação a essa URL retorna exatamente o que você definiu. Não há backend para escrever e nenhum servidor para hospedar.

Foi construído por Julien Lafont e lançado sob a licença Apache 2.0. A versão hospedada está em mocky.io, e como o código é público, você também pode hospedá-lo se preferir rodar sua própria instância.A ideia central é simples. Você está "projetando uma resposta por trás de uma URL". Esse é o produto inteiro, e esse foco é sua maior força.

O que você pode configurar

Mocky permite configurar as partes de uma resposta HTTP que importam para o teste de cliente:

• Código de status, para que você possa retornar um 200, um 404, ou um 500 sob demanda.
• Corpo da resposta, geralmente JSON, mas qualquer payload de texto funciona.
• Cabeçalhos HTTP, incluindo tipo de conteúdo e cabeçalhos personalizados.
• Um atraso na resposta, para que você possa simular uma rede lenta ou um upstream com latência.

Depois de salvar, o Mocky armazena a resposta e lhe entrega uma URL permanente. Você cola essa URL em seu código front-end, em seu teste ou em seu cliente HTTP, e pronto.

Um exemplo rápido

Digamos que seu back-end não esteja pronto, mas seu front-end precisa de um objeto de usuário para renderizar. Você abriria o designer do Mocky, definiria o status como 200, definiria Content-Type: application/json e colaria um corpo como este:

{
  "id": 42,
  "name": "Ada Lovelace",
  "role": "admin"
}

O Mocky retorna uma URL como https://run.mocky.io/v3/<algum-id>. Aponte seu aplicativo para ela, e cada solicitação receberá esse usuário de volta. Para uma visão mais ampla desse padrão, veja nossa explicação sobre como simular APIs online sem configurar um servidor.

Quando Mocky é a escolha certa

Mocky brilha quando suas necessidades são pequenas e pontuais:

• Você quer uma única resposta estática, rápida, sem conta.
• Você está compartilhando um payload fixo com um colega de equipe ou um tíquete de suporte.
• Você está reproduzindo um caso de erro, como uma resposta de erro interno do servidor 500, para um relatório de bug.
• Você não precisa que a resposta mude com base na solicitação.

Para esses trabalhos, Mocky é difícil de superar. É gratuito, carrega em um navegador, e você pode ter uma URL funcionando em menos de um minuto. Não super-projete um problema desse tamanho.

Onde Mocky começa a prejudicar

A mesma simplicidade que torna o Mocky ótimo também o limita. Cada URL do Mocky é uma resposta fixa. À medida que seu projeto cresce, esse modelo se torna insuficiente de algumas maneiras previsíveis.

• Sem dados dinâmicos. Cada chamador recebe o corpo idêntico. Você não pode retornar um usuário diferente para /users/1 versus /users/2, e não pode gerar dados realistas e variados.
• Sem correspondência de solicitação. Mocky não ramifica em parâmetros de consulta, valores de caminho ou corpos de solicitação. Uma URL, uma resposta.
• Organização frouxa. Uma API real tem dezenas de endpoints. Gerenciá-los como uma pilha de links Mocky separados se torna confuso rapidamente.
• Colaboração limitada. Não há espaço de trabalho compartilhado, versionamento e permissões de equipe em torno de seus mocks.
• Sem link de esquema. Seu mock e sua especificação OpenAPI vivem em lugares diferentes, então eles se afastam.

Quando você atinge dois ou três desses pontos, você superou uma ferramenta de resposta única. Esse é o momento de fazer a transição para uma plataforma de mock completa. Se você está avaliando a compensação orçamentária, nosso guia de servidores de mock de API gratuitos e baratos apresenta as opções.

Um gatilho comum é a equipe de front-end. Um desenvolvedor simula o objeto de usuário, outro simula a lista de pedidos, um terceiro simula o fluxo de autenticação. Com o Mocky, esses são três links não relacionados sem uma URL base compartilhada e sem uma maneira de trocar de ambiente. Com um servidor de mock real, são três endpoints em um projeto que respondem sob um único host, e você pode alternar entre dados de staging e produção em um só lugar.

A melhor alternativa ao Mocky: Apidog

Apidog mantém a melhor característica do Mocky, uma resposta personalizada por trás de uma URL compartilhável, e então adiciona as coisas que o Mocky deixa de fora: persistência em vários endpoints, dados baseados em esquema, respostas dinâmicas e colaboração em equipe. Você projeta endpoints, e o Apidog gera uma URL de mock hospedada que retorna códigos de status personalizados, cabeçalhos e corpos JSON, assim como o Mocky, mas vinculada ao seu design de API real.

Aqui está a diferença honesta. Mocky responde "me dê uma resposta fixa, gratuita, agora". Apidog responde "me dê um mock crível de uma API inteira que cresce com meu projeto".

Algumas coisas que o Apidog adiciona além do caso de uso do Mocky:

• Mock inteligente e dados gerados por IA. Em vez de codificar um corpo, o Apidog pode inferir valores realistas a partir dos nomes dos seus campos e do esquema, então `email` retorna um e-mail e `createdAt` retorna uma data.
• Suporte a Faker.js. Você pode conectar o Faker.js para gerar dados de mock dinâmicos para payloads variados e realistas em cada chamada.
• Regras de mock avançadas. Retorne respostas diferentes com base em parâmetros de consulta ou conteúdo da solicitação, o que é a correspondência de solicitação que o Mocky não consegue fazer.
• Mocking orientado por esquema. Seu mock é gerado a partir do seu design OpenAPI, então os dois permanecem sincronizados.
• Espaços de trabalho em equipe. Os mocks vivem em um projeto compartilhado com controle de versão e sincronização em tempo real, não espalhados por links únicos.

Você ainda obtém a parte simples. Precisa de um único endpoint que retorne um `200` com um corpo JSON fixo por trás de uma URL? O Apidog também faz isso, e você pode compartilhá-lo com sua equipe em um clique.

Mocky vs Apidog em um relance

Se você quiser comparar mais concorrentes lado a lado, nossa lista das melhores ferramentas de mocking de API e nosso resumo de mocking de endpoint REST aprofundam.

Como substituir uma URL do Mocky no Apidog

Sair de um único link do Mocky é rápido:

1. Baixe o Apidog e crie um projeto.
2. Adicione um endpoint, por exemplo GET /users/42.
3. Defina a resposta: defina o código de status, adicione cabeçalhos e escreva o corpo JSON, os mesmos campos que você teria digitado no Mocky.
4. Ative o mock. O Apidog gera uma URL de mock hospedada para esse endpoint.
5. Aponte seu front-end ou teste para a nova URL.

A partir daí, você pode adicionar extras, dados dinâmicos, regras condicionais, mais endpoints, sempre que precisar. Você não precisa usar os recursos avançados no primeiro dia.

A migração raramente é tudo de uma vez. A maioria das equipes mantém seus links Mocky existentes funcionando enquanto reconstroem os endpoints importantes no Apidog, então aposentam as URLs antigas quando o projeto está em um só lugar. Como o Apidog pode ler um arquivo OpenAPI, se você já tiver uma especificação, pode importá-la e obter URLs de mock para cada endpoint de uma vez, em vez de recriar cada resposta manualmente.

Perguntas frequentes

O Mocky é gratuito?

Sim. O Mocky é gratuito e de código aberto sob a licença Apache 2.0, e você não precisa de uma conta para criar um mock. As respostas são armazenadas no servidor, então a URL que você obtém permanece ativa. Se você precisar de mais do que uma única resposta fixa, uma plataforma mais completa como o Apidog oferece um nível gratuito com dados dinâmicos e recursos de equipe.

Qual a diferença entre mocky.io e um servidor de mock?

Uma URL Mocky é uma resposta pré-determinada. Um servidor de mock simula uma API inteira, com muitos endpoints, correspondência de requisições e dados que podem mudar por requisição. Se você é novo no conceito, nossa explicação sobre o que é uma API de mock explora o assunto do zero.

Posso retornar um código de status e cabeçalhos personalizados com Mocky?

Sim. É exatamente para isso que serve o Mocky. Você define o código de status, adiciona os cabeçalhos que deseja, escreve o corpo e o Mocky serve tudo isso a partir de uma única URL. O limite é que é sempre a mesma resposta, independentemente da solicitação.

Quando devo mudar do Mocky para uma plataforma de mock completa?

Mude quando precisar de mais do que uma resposta fixa: dados dinâmicos ou realistas, respostas condicionais, vários endpoints organizados juntos ou um espaço de trabalho compartilhado para sua equipe. Até então, a simplicidade do Mocky é uma característica, não uma falha.

Conclusão

Mocky é uma maneira limpa e gratuita de colocar uma resposta HTTP personalizada por trás de uma URL, e para necessidades rápidas e estáticas, é a ferramenta certa. No momento em que você precisa de dados dinâmicos, correspondência de solicitações, muitos endpoints ou colaboração em equipe, esse modelo de resposta única se esgota.

É aí que o Apidog entra. Ele cobre o mesmo trabalho de "projetar uma resposta por trás de uma URL", então se expande para mocking colaborativo, dinâmico e orientado por esquema à medida que sua API cresce. Baixe o Apidog para criar sua primeira URL de mock gratuitamente e mantê-la conforme seu projeto cresce.