Introdução

Durante os testes manuais em APIs, o ideal é testar diferentes cenários em cada endpoint, testar diferentes tipos de dados, limites e entre outros cenários de teste.

É importante realizar todos esses testes para garantir que o endpoint esteja funcionando bem.

Com isso, deixar os testes de endpoint com dados fixos pode não ser interessante, porque os testes manuais ficam muito mecânicos, não tem a imprevisibilidade que dados diferentes podem ser inseridos dentro da API.

Sendo assim no dia a dia pode acabar ficando comum esquecer de executar testes diferentes, como por exemplo um campo de nome sem o teste de limite máximo de caracteres, ou um campo de número sem um teste de número mínimo ou máximo.

Para isso, o ideal é utilizar dados aleatórios ao testar os endpoints.

Postman

O Postman é uma das ferramentas disponível para se testar endpoints, muito conhecida.

E no Postman é possível fazer configurações para que os campos sejam enviados com dados aleatórios automaticamente através de variáveis.

Com isso, a cada nova requisição, dados diferentes serão enviados.

Variáveis dinâmicas

O Postman já provém algumas variáveis prontas para uso, e a sintaxe é: {{$randomFullName}}.

Utilizando em um body de request fica algo como:

{
	"name": {{$randomFullName}}
}

Qualquer uma dessas variáveis pré prontas do Postman podem ser utilizadas nos testes de endpoints.

Os dados podem ser utilizados tanto no body da request quanto também nos parâmetros da rota, utilizando a mesma sintaxe.

E existe uma série dessas variáveis, como por exemplo:

Dados para pessoas

{{$randomFirstName}}: Nome aleatório.
{{$randomLastName}}: Sobrenome aleatório.
{{$randomFullName}}: Nome completo aleatório.
{{$randomJobTitle}}: Cargo profissional aleatório.
{{$randomPhoneNumber}}: Número de telefone aleatório.
{{$randomEmail}}: E-mail aleatório.

Dados para textos

{{$randomLoremWords}}: Palavras aleatórias.
{{$randomLoremSentence}}: Frase aleatória.
{{$randomLoremParagraph}}: Parágrafo aleatório.

Dados para localização

{{$randomCity}}: Cidade aleatória.
{{$randomCountry}}: País aleatório.
{{$randomZipCode}}: Código postal/CEP aleatório.
{{$randomLatitude}}: Latitude aleatória.
{{$randomLongitude}}: Longitude aleatória.

Dados para datas

{{$timestamp}}: Timestamp Unix atual (número).
{{$randomDatePast}}: Data aleatória no passado.
{{$randomDateFuture}}: Data aleatória no futuro.

Dados para Ids e Números

{{$guid}}: GUID/UUID aleatório.
{{$randomUUID}}: UUID versão 4.
{{$randomInt}}: Número inteiro aleatório (0 a 1000).
{{$randomPrice}}: Preço aleatório.

Dados para conta e ip

{{$randomUserName}}: Nome de usuário aleatório.
{{$randomPassword}}: Senha aleatória.
{{$randomIP}}: Endereço IP aleatório (IPv4).

Criar variáveis

Caso alguma dessas variáveis não atenda ao que precisa, tem algumas de criar novas variáveis para utilizar.

Dado fixo

Se for alguma informação que não precisa ser variável no projeto, como por exemplo um header padrão a ser recebido nas requests é possível criar diretamente no Environments, que são as variáveis de ambiente do projeto.

Para isso se atribui uma nova variável de ambiente atribuindo o valor desejado, como:

E para utilizar não precisa do $, pode fazer {{accept}} no local desejado e irá funcionar.

Dado aleatório

Na aba de pré-request script, é possível criar um script personalizado para criar uma variável com dado randômico da forma que preferir.

Exemplo:

const codeRandom =
  "ABC-" + Math.random().toString(36).substring(7).toUpperCase();
pm.variables.set("myCodeRandom", codeRandom);

Com esse script no pré-request, a variável {{$myCodeRandom}} fica disponível para ser utilizada onde preferir no endpoint.

Conclusão

É ideal utilizar dados aleatórios para os endpoints, isso reduz os vícios de teste de sempre utilizar os mesmos dados.

Ajuda muito na imprevisibilidade dos dados recebidos no endpoint, ajuda a garantir que os cenários estão cobertos.

Caso tenha alguma sugestão de melhoria nesse artigo, entre em contato comigo no Linkedln :)

Como usar dados randomicos no Postman