Simular um endpoint de API REST
Obtenha um endpoint JSON público para desbloquear seu frontend antes do backend existir.
Um endpoint de API REST mock é uma URL pública que retorna o JSON que você definiu, sem nenhum servidor próprio por trás. Você descreve o método, o código de status e o corpo da resposta uma vez, e o mock responde a todas as chamadas exatamente com isso. É a maneira mais rápida de desbloquear o trabalho no frontend enquanto o backend real ainda está sendo escrito: criar um mock e chamá-lo levou uma média de 0,73 segundos em 20 execuções de um cliente europeu, medido em 2026-09-08.
Qual JSON o mock deve retornar?
Retorne a resposta que sua interface realmente espera, não um substituto simplificado. Todo o valor do mock é que você escreve código real de análise contra ele, então o formato deve corresponder ao contrato que você concordou com a equipe de backend.
- Mantenha o envelope. Se a API real envolve os resultados como
{"data": [...], "total": 42}, simule o envelope também. Código escrito contra um array simples quebra no dia em que o endpoint real chega. - Mantenha os tipos. Um id que é uma string em produção deve ser uma string aqui. O desvio silencioso de número para string é a causa mais comum de um mock que funciona e uma chamada real que não.
- Inclua os campos difíceis. Nulos, arrays vazios e chaves opcionais são exatamente o que seu código de renderização erra, então coloque pelo menos um de cada na amostra.
Como você simula respostas de erro e CORS?
Um mock que retorna apenas 200 testa metade do seu código. Defina response_status como 404, 422 ou 500 e aponte um segundo mock para ele, de modo que seus caminhos de erro sejam exercitados de forma tão deliberada quanto o caminho feliz. A referência de códigos de status MDN é a maneira mais rápida de escolher o erro correto.
Se você estiver chamando o mock do navegador em vez do curl, defina cors_enabled como true. Sem isso, o navegador bloqueia a resposta antes que seu código a veja, e o erro do console raramente cita a causa real — veja MDN sobre CORS. Para corpos de erro que valem a pena padronizar, a RFC 9457 Problem Details oferece um formato que o resto do setor já analisa.
Como você troca o mock pela API real depois?
Coloque a URL base na configuração no primeiro dia, nunca embutida (inline) num componente. Aponte para a URL do mock agora e para o host real depois, e a troca será uma mudança de uma linha em vez de uma busca por toda a base de código.
Mocks aqui duram sete dias por padrão e até trinta no máximo, o que geralmente é maior do que o intervalo que você está cobrindo. Essa expiração é uma funcionalidade: um mock que sobrevive silenciosamente ao endpoint real é como um dado falso acaba em produção. Se um colega de equipe precisar do mesmo dado, compartilhe o comando de criação em vez da URL, para que todos possam gerá-lo de novo.
O que geralmente dá errado?
- Simular a resposta que você gostaria de ter. Projete o mock com base no contrato real do backend, não no que seria conveniente renderizar.
- Esquecer o tipo de conteúdo. Sem
"content_type": "application/json"muitos clientes te entregam uma string e seu analisador falha em JSON válido. - Testar apenas o caminho feliz. Se nenhum teste chega a ver um 500, seu tratamento de erros não está comprovado, muito menos correto.
- Deixar a URL do mock em uma branch mesclada. Configuração, não código-fonte, e a expiração de sete dias impede que se torne permanente.
Quando usar isso
Quando o backend não está pronto, o frontend para. Monte um mock que retorne o JSON exato que sua interface espera, obtenha uma URL pública e construa com base nisso agora — troque pela API real mais tarde.
Criar o mock
curl -X POST https://quickmock.dev/api/mocks \
-H 'Content-Type: application/json' \
-d '{
"method": "GET",
"response_status": 200,
"content_type": "application/json",
"response_body": "{\"users\":[{\"id\":1,\"name\":\"Ada\"}]}"
}'
Chamá-lo
curl https://quickmock.dev/m/<slug>
O que você obtém
{"users":[{"id":1,"name":"Ada"}]}
FAQ
- Preciso de uma conta para criar um endpoint mock de API REST?
- Não. Não há cadastro, nem e-mail, nem chave de API — você faz o POST da definição do mock e recebe uma URL ativa de volta. Cada mock retorna um token de administrador de uso único que você guarda caso queira editá-lo ou excluí-lo depois.
- Por quanto tempo o endpoint fica ativo?
- Sete dias por padrão, trinta no máximo. Isso cobre o intervalo habitual entre "o frontend está pronto" e "o backend está pronto", e a expiração impede que simulações desatualizadas vazem para a produção.
- A resposta pode mudar entre as chamadas?
- Sim. Use tokens faker para um corpo novo a cada chamada, uma sequência de respostas para retornar status diferentes em ordem, ou um atraso para simular um endpoint lento. Um corpo fixo é apenas o caso mais simples.
Construa o seu próprio
Criar um mockTemplates prontos para isso: Simular uma resposta de token OAuth2, Simular um documento de descoberta OpenID Connect, Simular um endpoint JWKS para verificação de JWT
Guias relacionados
Última atualização: 2026-10-17