Gerador de Mock API (JSON)

Como usar Gerador de Mock API (JSON)

Desenvolver um frontend antes da API estar pronta é um dos desafios mais comuns no desenvolvimento moderno. A solução clássica é criar um mock: um endpoint falso que retorna dados fictícios com estrutura verossímil para que o time de front-end possa avançar em paralelo com o back-end. Antes de ferramentas de geração automática, esse processo era manual e tedioso — alguém precisava sentar e escrever arrays de objetos JSON a mão, inventando nomes, IDs, datas e outros campos de modo a parecer realista o suficiente para desenvolver contra. JSON Placeholder foi um pioneiro nessa ideia, mas tem estrutura fixa. Esta ferramenta gera payloads com três temas — animais, pessoas e produtos — com metadados de contagem e timestamp, cobrindo boa parte dos cenários de prototipação.

Mocks de API têm um papel importante além da prototipação: testes de integração e unitários de frontend dependem de dados previsíveis e controlados. Quando você testa um componente React que renderiza uma lista de produtos, prefere receber dados de uma API real (que pode estar fora do ar, lenta ou com dados inconsistentes) ou de um mock local com estrutura garantida? A resposta óbvia é o mock. Ferramentas como MSW (Mock Service Worker) se tornaram padrão no ecossistema React exatamente por isso: permitem interceptar chamadas fetch no navegador e responder com payloads controlados, sem depender de servidor real.

Uma payload com estrutura consistente — todos os itens com os mesmos campos, tipos corretos, sem nulos inesperados — é essencial para desenvolvimento de frontend confiável. No mundo real, APIs costumam retornar dados sujos: campos opcionais às vezes presentes, às vezes ausentes; tipos misturados (números como strings, booleans como 0 ou 1); arrays que ora têm um item ora são vazios. Trabalhar com um mock de boa qualidade primeiro ensina o componente a lidar com a estrutura esperada, e depois você adiciona os casos de edge — ao contrário de descobrir esses casos no ambiente de staging às 23h de uma sexta-feira.

Esta ferramenta gera um array JSON com metadados de tema, contagem e timestamp na chave `meta`, e os itens em `items`. O JSON gerado pode ser usado diretamente como response fixture em Jest ou Vitest, servido por um servidor mock local com `json-server`, ou colado como resposta de exemplo em ferramentas de documentação como Swagger UI e Postman. Para cenários mais complexos com schemas personalizados e relações entre entidades, ferramentas como Faker.js (no ecossistema Node) ou a ferramenta irmã de Faker SQL Insert deste site cobrem casos mais avançados.