Passar Dados Entre Pedidos

Em cenários de testes automatizados, passar dados entre vários pedidos é muito comum. Os casos típicos incluem:

O Pedido 1 é um pedido de início de sessão que devolve um token; o Pedido 2 utiliza este token para solicitar outros dados.

O Pedido 1 devolve um ID; o Pedido 2 executa operações com base neste ID.

O Pedido 1 devolve uma lista; o Pedido 2 utiliza dados desta lista.

Para estes cenários, o Apidog fornece duas soluções diferentes para tratar a passagem de dados entre pedidos. Pode escolher a solução adequada com base no problema específico em questão.

Método	Vantagens	Limitações	Disponibilidade
Obter dados do passo anterior	Simples, sem necessidade de variáveis adicionais	Ligeiramente incómodo quando os dados precisam de ser referenciados várias vezes	Apenas módulo de Testes
Utilizar variáveis	Conveniente para várias referências	Ligeiramente mais complexo para referências únicas	Módulos de Testes e APIs

Obter Dados do Passo Anterior

Vamos considerar um cenário em que o Pedido 1 é um pedido de início de sessão que devolve um token, e o Pedido 2 utiliza este token para solicitar dados adicionais.

Adicione o pedido de início de sessão (Pedido 1) ao cenário de teste.

Adicione o pedido de consulta (Pedido 2) ao cenário de teste.

O parâmetro de consulta do Pedido 2 precisa de incluir o token devolvido pelo Pedido 1. Clique no ícone de "varinha mágica" 🪄 no campo do token nos parâmetros de consulta do Pedido 2 e selecione "Obter dados do passo anterior".

Escolha o Pedido 1 para obtenção de dados, selecione o corpo da resposta e utilize JSONPath para extrair o token devolvido pelo Pedido 1, como $.token.

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

Clique no botão "Executar" no cenário de Teste para passar os dados do Pedido 1 para o Pedido 2 com sucesso.

A funcionalidade "Obter dados do passo anterior" está DISPONÍVEL APENAS no módulo "Testes" e não no módulo "APIs".

Ao utilizar "Obter dados do passo anterior", o valor SÓ pode ser obtido quando todo o cenário de teste é executado em conjunto; não pode ser acedido ao executar passos individuais.

Referenciar Dados do Passo Anterior Utilizando Sintaxe de Variáveis

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

'2' representa o ID do passo, que pode ser encontrado em cada passo de teste.

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

'token' representa os dados 'token' no nível seguinte dentro do corpo. Pode utilizar a sintaxe JSONPath para extrair os dados pretendidos.

Os dados do passo anterior podem ser utilizados em várias partes do pedido, tais como parâmetros do pedido, cabeçalhos, autenticação e mais. Também pode inserir diretamente os dados no corpo do pedido, conforme mostrado abaixo.

É importante notar que, se precisar de utilizar dados do passo anterior nos seus scripts, não pode referenciar diretamente variáveis utilizando a sintaxe {{variable}}. Em vez disso, deve utilizar pm.variables.get para referenciar dados do passo anterior. Por exemplo:

Referência de Sintaxe

Categoria	Função	Exemplo de Sintaxe
Pedido	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 (formulário)	`{{$.<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 em loop ForEach)	`{{$.<loop step id>.element.<field path>}}`
	Índice	`{{$.<loop step id>.index}}`

Utilizar Variáveis para Passar Dados

Vamos considerar um cenário em que o Pedido 1 é um pedido de início de sessão que devolve um token, e o Pedido 2 utiliza este token para solicitar dados adicionais.

Adicione o pedido de início de sessão (Pedido 1) ao cenário de teste.

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

Saiba mais sobre Extrair variável.

Adicione o pedido de consulta (Pedido 2) ao cenário de teste.

Referencie a variável {{token}} nos parâmetros de consulta do Pedido 2.

Clique no botão "Executar" no cenário de Teste para passar os dados do Pedido 1 para o Pedido 2 com sucesso.

FAQ

P: Porque não consigo referenciar dados do passo anterior com sucesso?

R: Em primeiro lugar, certifique-se de que está agora no módulo "Testes". A funcionalidade "Referenciar dados do passo anterior" está disponível apenas no módulo de Testes, mas não no módulo de APIs.

Se tiver a certeza de que está agora no módulo de Testes, mude para o separador "Pedido Real" para confirmar se os dados do passo anterior referenciados no pedido foram incorporados com sucesso.

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

Neste caso, considere os seguintes motivos comuns:

Executou todo o cenário de teste em vez de apenas um único passo? Referenciar dados do passo anterior requer a execução do cenário de teste completo para produzir efeito.

Verifique se o ID do passo está correto e corresponde ao passo que pretende referenciar.

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

Passar Dados Entre Pedidos

Obter Dados do Passo Anterior#

Referenciar Dados do Passo Anterior Utilizando Sintaxe de Variáveis#

Referência de Sintaxe#

Utilizar Variáveis para Passar Dados#

FAQ#

Obter Dados do Passo Anterior

Referenciar Dados do Passo Anterior Utilizando Sintaxe de Variáveis

Referência de Sintaxe

Utilizar Variáveis para Passar Dados

FAQ