Passar Dados Entre Requisições

Em cenários de testes automatizados, passar dados entre múltiplas requisições é muito comum. Casos típicos incluem:

A Requisição 1 é uma requisição de login que retorna um token; a Requisição 2 usa esse token para solicitar outros dados.

A Requisição 1 retorna um ID; a Requisição 2 realiza operações com base nesse ID.

A Requisição 1 retorna uma lista; a Requisição 2 usa dados dessa lista.

Para esses cenários, o Apidog fornece duas soluções diferentes para lidar com a passagem de dados entre requisições. Você pode escolher a solução adequada com base no problema específico em questão.

Método	Vantagens	Limitações	Disponibilidade
Recuperar dados da etapa anterior	Simples, não requer variáveis adicionais	Um pouco trabalhoso quando os dados precisam ser referenciados várias vezes	Somente módulo Tests
Usar variáveis	Conveniente para múltiplas referências	Um pouco mais complexo para referências únicas	Módulos Tests e APIs

Recuperar Dados da Etapa Anterior

Vamos considerar um cenário em que a Requisição 1 é uma requisição de login que retorna um token, e a Requisição 2 usa esse token para solicitar dados adicionais.

Adicione a requisição de login (Requisição 1) ao cenário de teste.

Adicione a requisição de consulta (Requisição 2) ao cenário de teste.

O parâmetro de consulta da Requisição 2 precisa incluir o token retornado pela Requisição 1. Clique no ícone de "varinha mágica" 🪄 no campo de token nos parâmetros de consulta da Requisição 2 e selecione "Recuperar dados da etapa anterior".

Escolha a Requisição 1 para recuperação dos dados, selecione o corpo da resposta e use JSONPath para extrair o token retornado pela Requisição 1, como $.token.

Clique em Inserir, e você verá {{$.2.response.body.token}} inserido como parâmetro de consulta.

Clique no botão "Run" no cenário de teste para passar os dados da Requisição 1 para a Requisição 2 com sucesso.

O recurso "Recuperar dados da etapa anterior" está DISPONÍVEL SOMENTE no módulo "Tests" e não no módulo "APIs".

Ao usar "Recuperar dados da etapa anterior", o valor SOMENTE pode ser obtido quando todo o cenário de teste é executado em conjunto; ele não pode ser acessado ao executar etapas individuais.

Referenciar Dados da Etapa Anterior Usando Sintaxe de Variável

Usando o exemplo de {{$.2.response.body.token}} do texto anterior:

'2' representa o ID da etapa, que pode ser encontrado em cada etapa de teste.

'response.body' indica a posição dos dados da etapa anterior. Isso pode incluir dados do cabeçalho ou corpo da requisição, ou do cabeçalho ou corpo da resposta, entre outros. Veja abaixo os detalhes.

'token' representa os dados 'token' no próximo nível dentro do corpo. Você pode usar a sintaxe JSONPath para extrair os dados desejados.

Os dados da etapa anterior podem ser utilizados em várias partes da requisição, como parâmetros da requisição, cabeçalhos, autenticação e muito mais. Você também pode inserir os dados diretamente no corpo da requisição, conforme mostrado abaixo.

É importante observar que, se você precisar usar dados da etapa anterior em seus scripts, não poderá referenciar variáveis diretamente usando a sintaxe {{variable}}. Em vez disso, você deve usar pm.variables.get para referenciar dados da etapa anterior. Por exemplo:

Referência de Sintaxe

Categoria	Função	Exemplo de Sintaxe
Requisição	URL	`{{$.<step id>.request.url}}`
	Parâmetro de caminho	`{{$.<step id>.request.pathParam.<field name>}}`
	Consulta	`{{$.<step id>.request.query.<field name>}}`
	Cabeçalho	`{{$.<step id>.request.header.<field name>}}`
	Corpo (form)	`{{$.<step id>.request.body.<field name>}}`
	Corpo (json)	`{{$.<step id>.request.body.<field path>}}`
Resposta	Corpo	`{{$.<step id>.response.body.<field path>}}`
	Cabeçalho	`{{$.<step id>.response.header.<field name>}}`
	Cookie	`{{$.<step id>.response.cookie.<field name>}}`
Loop	Elemento (elemento de array no loop ForEach)	`{{$.<loop step id>.element.<field path>}}`
	Índice	`{{$.<loop step id>.index}}`

Usar Variáveis para Passar Dados

Vamos considerar um cenário em que a Requisição 1 é uma requisição de login que retorna um token, e a Requisição 2 usa esse token para solicitar dados adicionais.

Adicione a requisição de login (Requisição 1) ao cenário de teste.

Nos pós-processadores da Requisição 1, adicione uma ação "Extrair Variável" para extrair $.token como {{token}}.

Saiba mais sobre Extrair variável.

Adicione a requisição de consulta (Requisição 2) ao cenário de teste.

Referencie a variável {{token}} nos parâmetros de consulta da Requisição 2.

Clique no botão "Run" no cenário de teste para passar os dados da Requisição 1 para a Requisição 2 com sucesso.

Perguntas Frequentes

P: Por que não consigo referenciar dados da etapa anterior com sucesso?

R: Primeiro, certifique-se de que você está agora no módulo "Tests". O recurso "Referenciar dados da etapa anterior" está disponível somente no módulo Tests, mas não no módulo APIs.

Se você tiver certeza de que está no módulo Tests, alterne para a aba "Actual Request" para confirmar se os dados da etapa anterior referenciados na requisição foram incorporados com sucesso.

Se a referência na requisição real ainda aparecer como {{$.n.response.body.abc}} em vez de mostrar os dados reais, isso indica que a referência não foi aplicada.

Nesse caso, considere os seguintes motivos comuns:

Você executou todo o cenário de teste em vez de apenas uma única etapa? Referenciar dados da etapa anterior exige a execução do cenário de teste completo para entrar em vigor.

Verifique se o ID da etapa está correto e corresponde à etapa que você pretende referenciar.

Certifique-se de que o JSONPath usado corresponde com precisão à fonte de dados.

Passar Dados Entre Requisições

Recuperar Dados da Etapa Anterior#

Referenciar Dados da Etapa Anterior Usando Sintaxe de Variável#

Referência de Sintaxe#

Usar Variáveis para Passar Dados#

Perguntas Frequentes#

Recuperar Dados da Etapa Anterior

Referenciar Dados da Etapa Anterior Usando Sintaxe de Variável

Referência de Sintaxe

Usar Variáveis para Passar Dados

Perguntas Frequentes