Objetivo e escopo
Crie payloads mock repetíveis, gere valores de limite com formato válido, encontre nomes de campo confusos e revise um mock server temporário antes de compartilhá-lo.
Este guia transforma o escopo informado em um resultado revisável. Mantenha a fonte, os resultados intermediários e as decisões para que a próxima pessoa entenda o que foi verificado e por quê.
Preparar evidências e tomar decisões
Prepare as estruturas de requisição e resposta, os campos obrigatórios, os valores enumerados e alguns casos válidos e inválidos.
Use somente valores inventados; remova credenciais reais, tokens de acesso, registros de clientes e outros dados pessoais antes de inserir a fixture.
Defina o ambiente de teste, a duração do mock, a pessoa responsável pela fixture e as evidências que precisam ser guardadas para a aceitação.
Decisão: O campo precisa de um perfil de dados ou de um padrão rígido?. Escolha Test Data Faker Builder para registros estruturados e perfis de campos repetíveis. Escolha Regex to String Generator quando um identificador, CEP ou versão tiver de seguir um padrão específico; guarde o padrão e os exemplos na revisão.
Decisão: A fixture já pode ser exposta como endpoint mock?. Não publique logo após gerar. Primeiro resolva colisões de nomes, examine os limites, remova conteúdos sensíveis e confirme que a definição aponta para uma superfície isolada e não produtiva.
Concluir o fluxo de trabalho
1. Monte a fixture estruturada
Configure no Test Data Faker Builder a estrutura do registro, os campos obrigatórios, as categorias controladas e uma quantidade repetível de exemplos. Mantenha separados uma resposta normal, um resultado vazio e uma falha de validação intencional. Usar test-data-faker-builder.
2. Preencha valores com formato rígido
Gere identificadores e outras strings restritas a partir das expressões regulares revisadas. Confira correspondências e quase correspondências que devem falhar para cobrir limites sem confundir sintaxe com validade de negócio. Usar regex-to-string-generator.
3. Revise nomes e riscos de colisão
Envie o JSON ou schema montado ao detector de conflitos de nomes. Renomeie abreviações ambíguas, campos visualmente parecidos e prefixos concorrentes antes que o cliente ou a documentação passe a depender deles. Usar mock-data-naming-conflict-detector.
4. Exponha o mock revisado com segurança
Crie a definição temporária somente depois dos controles anteriores. Verifique caminhos, métodos, templates de resposta, expiração e premissas de acesso; use dados inventados e registre que o mock não testa comportamento, latência, autorização ou persistência de um serviço real. Usar api-mock-server.
Verificar o resultado antes da entrega
- A fixture contém os campos obrigatórios e valores representativos repetíveis, com casos válidos, vazios e intencionalmente inválidos separados.
- Os valores com restrição de formato obedecem aos padrões declarados, e a revisão de nomes não deixa campos visualmente confusos ou colisões de prefixos sem solução.
- A definição mock expõe apenas dados inventados e não sensíveis na superfície temporária prevista; a revisão declara que isso não substitui testes de um serviço real.
Perguntas frequentes
- Este fluxo testa uma API real? Não. Ele prepara e expõe uma fixture mock temporária. Comportamento real, autenticação, persistência, latência e compatibilidade de integração exigem testes de contrato ou integração separados, como o workflow relacionado de API Contract Testing.
- Que dados são seguros para uma fixture? Use nomes, identificadores, endereços, tokens e estados de conta inventados. Nunca cole credenciais de produção, tokens de acesso, exportações de clientes ou outros dados pessoais na fixture ou na definição mock.
- Por que gerar correspondências e quase correspondências de regex? As correspondências mostram o formato esperado pelo cliente, enquanto as quase correspondências verificam rejeição e limites. Uma correspondência de regex não prova que o valor é único, autorizado ou válido para o negócio.
- Quando a fixture pode ser compartilhada? Somente depois que campos, limites, revisão de nomes, ausência de dados sensíveis, configuração do mock e escopo não produtivo forem registrados e aprovados pela pessoa responsável.