Apidog Docs
🇧🇷 Português (Brasil)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇧🇷 Português (Brasil)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇧🇷 Português (Brasil)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. Testes automatizados
  • Back to home
  • Central de suporte
  • Centro de Suporte do Apidog
  • Importar/exportar
    • Como importar dados de API para o Apidog?
    • Como importar cURL no Apidog?
    • Como migrar ambientes do Postman para o Apidog?
    • Como agrupar endpoints automaticamente na importação do Swagger/OpenAPI?
  • Envio de requisições
    • O Apidog oferece suporte a Socket.IO?
    • Por que o “+” no valor do parâmetro é decodificado como um espaço?
    • Como enviar uma requisição no Apidog?
    • Como enviar uma requisição GraphQL no Apidog?
    • Como enviar uma requisição gRPC no Apidog?
    • Como enviar uma requisição SOAP/WebService no Apidog?
    • Como enviar uma requisição WebSocket no Apidog?
    • O Apidog oferece suporte a scripts de pré-requisição/teste e assertivas em APIs WebSocket?
    • Como enviar uma requisição SSE no Apidog?
    • Como adicionar cabeçalhos padrão no nível da pasta?
    • O Apidog oferece suporte a scripts de pré-requisição/teste e assertivas em APIs gRPC?
    • Erro de resolvedor DNS ELANREFUSED.DNS
    • Por que estou recebendo um erro "socket hang up" ao enviar uma requisição?
    • Correção de erros de requisição
      • Corrigindo o erro read ECONNRESET
      • Corrigindo o erro ECONNREFUSED
      • Corrigindo o erro ETIMEDOUT
      • Corrigindo o erro ENOTFOUND: Couldn't resolve host
      • Corrigindo ENOTFOUND: getaddrinfo ENOTFOUND www Error
      • Corrigindo o erro connect EHOSTUNREACH
  • Projeto de APIs
    • Como usar variáveis no caminho?
    • Posso usar um componente de resposta como a resposta padrão?
    • Como verificar quem modificou um endpoint?
    • Como posso excluir pastas de endpoints em massa no Apidog?
    • Como posso adicionar/remover prefixos em massa ao caminho dos endpoints?
    • Como mover o nível de uma propriedade no Editor de Schema?
    • Se uma propriedade de string tiver vários valores enumerados e for usada em diversos locais, como esse enum poderá ser referenciado de forma consistente em todos eles?
    • Como obter o ID da pasta de recursos do Apidog?
    • Como obtenho o ID da pasta de recursos do Apidog?
    • Como uso variáveis em um caminho de URL?
    • O que devo fazer se um endpoint, documento ou cenário de teste for excluído acidentalmente?
    • O Apidog oferece suporte a código de requisição para endpoints personalizados?
    • Como agrupar endpoints automaticamente ao importar Swagger/OpenAPI para o Apidog?
    • Como gerar dados de array sem duplicação em respostas mock?
    • Por que a entrada de "#" não é compatível no caminho?
  • Depuração de APIs
    • Como o Apidog se integra a sistemas de gerenciamento de chaves de terceiros?
    • Por que a mesma requisição funciona corretamente em outras ferramentas (como o Postman), mas não no Apidog?
    • Como buscar valores de variáveis no banco de dados no Apidog?
    • Como migrar ambientes de outras ferramentas para o Apidog?
    • Como criar assertivas usando scripts no Apidog?
    • JSONPath só consegue extrair arrays. Como podemos extrair um único elemento de dentro deles no Apidog?
    • Como configurar operações de banco de dados no Apidog quando ambientes diferentes têm credenciais de conta de banco de dados diferentes?
    • Como obter a URL base do serviço em um script personalizado?
    • Por que o Apidog relata um erro de exceder o comprimento máximo de string do Node.js quando a resposta da API é grande demais?
    • Qual é o limite de tamanho para impressão no console? Por que recebo um erro ao imprimir arquivos grandes?
    • Como resolver erros de conexão com banco de dados DB2 no Windows?
    • Por que estou recebendo o erro NJS-045 ao conectar a um banco de dados Oracle no Apidog?
    • Como gerar valores dinâmicos em scripts personalizados do Apidog?
    • Por que a requisição do cliente para o mesmo endpoint é bem-sucedida, mas ocorre um erro ao depurar no lado web: "Não foi possível solicitar o endereço"?
    • Por que o Apidog relata um erro quando a resposta é muito grande?
    • Como você usa o endpoint de gravação do Apidog?
    • Ao definir uma resposta de endpoint, é permitido que o endpoint não tenha conteúdo de resposta?
    • Como obter a baseURL do serviço em um script personalizado?
    • Como visualizar o pacote original no Apidog?
    • Por que estou vendo o erro "Invalid URI xxx" ao fazer uma requisição?
    • Como faço uma requisição assíncrona em um script do Apidog?
    • Por que vejo a mensagem "Couldn't resolve host" ao enviar uma requisição?
    • Qual é o limite de tamanho de impressão do console? Por que recebo um erro ao imprimir um arquivo grande?
    • Como faço upload de um arquivo em uma requisição de endpoint?
    • O que fazer se o Apidog travar ou os dados da resposta não forem exibidos?
    • URI de redirecionamento oficial usada pelo Apidog para OAuth2.0
  • Dados de API mock
    • Como simular APIs automaticamente?
    • O que o mock do Apidog pode fazer?
    • Como simular dados fixos de API no Apidog?
    • Como fazer mock de dados condicionais no Apidog?
    • Como habilitar o cloud mock no Apidog?
    • Como habilitar o mock auto-hospedado no Apidog?
    • O Apidog oferece suporte a mocks de APIs WebSocket?
    • Por que o navegador não retorna conteúdo ao solicitar o endpoint de mock?
  • Testes automatizados
    • Por que os cenários de teste são executados sem problemas no meu cliente local, mas ocorrem erros ao executá-los no Apidog CLI ou runner?
    • Como criar um cenário de teste no Apidog?
    • Como passar dados entre etapas de teste?
    • Por que não consigo referenciar dados da etapa anterior com sucesso?
    • Como usar o loop foreach no Apidog?
    • Quais são as diferenças entre sincronizar dados de endpoints/casos de endpoint?
    • Como usar dados de teste no Apidog?
    • Como recuperar dados de teste em scripts no Apidog?
    • Como executar cenários de teste em lote no Apidog?
    • Como agendar tarefas de teste no Apidog?
    • Como executar teste de desempenho no Apidog?
    • Como posso visualizar as requisições e respostas reais nos testes de desempenho?
    • Como posso exportar relatórios de teste de desempenho no Apidog?
    • Como usar resultados de consultas de banco de dados como parâmetros para requisições de API em loop?
    • Capture e valide webhooks do Stripe no ApiDog durante CI/CD
    • Como resolver o erro "Error: unable to verify the first certificate on runner"?
    • Erro "Not Found" no contêiner Docker do General Runner.
    • Como definir o host do servidor para o General Runner na versão Web do Apidog?
    • Por que o cenário de teste agendado terminou com 0 requisições?
    • O que devo fazer se o parâmetro de upload de arquivo não puder ser encontrado no Runner ou na CLI?
    • Como usar o Runner para executar um cenário de teste com uma etapa de upload de arquivo?
    • Como resolvo o erro "Error: unable to verify the first certificate on runner"?
    • Como você acessa e pesquisa os logs do runner para identificar o problema quando ocorre uma falha com um runner?
    • O que devo fazer se o parâmetro do endpoint for um arquivo de upload e não puder ser encontrado no Runner ou na CLI?
    • Por que as etapas de teste não são sincronizadas automaticamente quando o caso de uso da API é alterado?
    • Por que usar múltiplos sinais de dólar em um documento Markdown faz com que algum conteúdo não seja exibido corretamente?
    • O Runner auto-hospedado gera um relatório de teste no servidor após executar uma tarefa?
    • Posso adicionar pré/pós-processadores unificados a requisições em um cenário de teste?
    • Como posso manter valores dinâmicos consistentes durante uma única execução de teste automatizado?
  • Publicar documentação de API
    • Como ocultar todos os logotipos da Apidog em documentos publicados?
    • Quando a especificação da API for atualizada, a documentação da API será alterada?
    • Como compartilhar APIs com colaboradores no Apidog?
    • Como personalizar o domínio das documentações do Apidog?
    • Como criar documentação multiversão no Apidog?
    • Escopo de compartilhamento para Sites de Documentação Publicados no Apidog
    • Escopo de compartilhamento para a lista Share Doc no Apidog
    • Por que o Share Docs publicado não está mostrando o hostname?
    • Como os usuários da documentação podem modificar a URL base em documentações compartilhadas?
    • Posso duplicar um documento publicado do Apidog para usar no meu próprio projeto?
    • Como Compartilhar Cabeçalhos (por exemplo, Token) na Documentação Online do Apidog?
    • Por que meu membro da equipe não consegue encontrar a documentação publicada?
    • Como corrijo a expiração de um certificado SSL ou o erro Cloudflare 526 no meu domínio personalizado?
    • SMTP personalizado configurado com sucesso, mas usuários na lista de permissões não recebem e-mails de OTP
  • Markdown
    • Como usar cartões para vincular a várias páginas ou endpoints dentro do Apidog?
    • Por que alguns conteúdos não são exibidos corretamente ao usar vários símbolos $ em documentos Markdown?
    • Como usar imagens com fundo transparente no Markdown do Apidog?
    • Como definir a largura da coluna de uma tabela Markdown?
    • Como posso inserir APIs internas, documentos, esquemas de dados ou pastas em um documento Markdown?
    • Como adicionar um link para um documento ou endpoint dentro de um projeto em um componente de cartão do Apidog?
  • Branches
    • Como acessar a branch de sprint?
  • Administração
    • Como instalar o cliente Apidog silenciosamente?
    • Por que estou vendo um erro de “Sem permissão” apesar de ter acesso de administrador?
    • Como verifico o número da versão do runner?
    • O Apidog oferece suporte ao Windows 7?
    • Por que o Apidog mostra o erro "Cannot locate program entry point DiscardVirtualMemory in dynamic link library KERNEL32.dll" após a instalação?
    • Alterações de assinatura e reembolsos
    • As requisições web funcionam, mas o app recebe "read ECONNRESET" — por quê?
    • Por que não consigo abrir o Apidog após uma atualização do sistema Windows?
    • Por que o Apidog não abre após a atualização do sistema Windows
  • Cobrança
    • Posso configurar uma conta de cobrança separada para minha equipe no Apidog?
    • Problemas de acesso da equipe e faturamento no Apidog
    • Membro convidado da equipe não consegue acessar o Apidog.
    • Transferir uma equipe pessoal paga para uma organização
  • On-premises
    • Gerenciamento de usuários e acesso na versão Self-Hosted (Enterprise) do Apidog
  • Web e cliente
    • Download e instalação da versão desktop para Linux
  1. Testes automatizados

Como passar dados entre etapas de teste?

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 apropriada com base no problema específico em questão.
Recuperar dados da etapa anterior: Este recurso permite que você use diretamente dados de requisições anteriores em requisições subsequentes.
A vantagem é a simplicidade, sem a necessidade de introduzir variáveis adicionais.
No entanto, pode se tornar um pouco trabalhoso quando os dados precisam ser referenciados várias vezes.
O recurso Recuperar dados da etapa anterior pode ser usado SOMENTE no módulo "Testes" e não no módulo "APIs".
Usar variáveis: Adicione "Extrair Variáveis" no pré-processador da requisição anterior para armazenar os dados necessários em uma variável e, em seguida, chame essa variável nas requisições subsequentes.
A vantagem é a conveniência ao referenciar dados várias vezes, mas pode ser um pouco mais complexo para referências únicas.
Variáveis podem ser usadas tanto no módulo "Testes" quanto no módulo "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.
1
Adicione a requisição de login (Requisição 1) ao cenário de teste.
2
Adicione a requisição de consulta (Requisição 2) ao cenário de teste.
3
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".
4
Escolha a Requisição 1 para recuperação de dados, selecione o corpo da resposta e use JSONPath para extrair o token retornado pela Requisição 1, como $.token.
5
Clique em Inserir, e você verá {{$.2.response.body.token}} inserido como o parâmetro de consulta.
6
Clique no botão "Executar" no cenário de Teste para passar com sucesso os dados da Requisição 1 para a Requisição 2.
O recurso "Recuperar dados da etapa anterior" está DISPONÍVEL SOMENTE no módulo "Testes" 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 do corpo da requisição, ou do cabeçalho ou do corpo da resposta, entre outros. Veja abaixo os detalhes.
'token' representa os dados de '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 mais. Você também pode inserir diretamente os dados 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çãoURL{{$.<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>}}
RespostaCorpo{{$.<step id>.response.body.<field path>}}
Cabeçalho{{$.<step id>.response.header.<field name>}}
Cookie{{$.<step id>.response.cookie.<field name>}}
LoopElemento (elemento de array em 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.
1
Adicione a requisição de login (Requisição 1) ao cenário de teste.
2
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.
3
Adicione a requisição de consulta (Requisição 2) ao cenário de teste.
4
Referencie a variável {{token}} nos parâmetros de consulta da Requisição 2.
5
Clique no botão "Executar" no cenário de Teste para passar com sucesso os dados da Requisição 1 para a Requisição 2.
Modified at 2026-06-11 10:21:25
Previous
Como criar um cenário de teste no Apidog?
Next
Por que não consigo referenciar dados da etapa anterior com sucesso?
Built with