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 criar um cenário de teste no Apidog?

Criar um cenário de teste#

Ao abrir o Apidog, navegue até o módulo “Tests” e clique no + ao lado da barra de pesquisa para criar um novo cenário de teste. Selecione o diretório apropriado para ele e defina a prioridade para concluir a criação.

Adicionar etapas de teste#

Depois de configurar seu cenário de teste no Apidog, você pode começar a preenchê-lo com requisições. Há várias maneiras de adicionar requisições, cada uma adaptada a diferentes necessidades e níveis de flexibilidade:
1.
Requisições vinculadas à especificação da API—Essas requisições podem ser atualizadas à medida que a especificação da API muda:
a. Importar da especificação do endpoint: Este método envolve importar requisições diretamente da definição estruturada dentro da especificação da API. Ele garante que seus testes estejam alinhados à interface documentada da API, embora talvez seja necessário ajustar manualmente os parâmetros da requisição para atender a condições específicas de teste.
b. Importar de caso de endpoint: Use esta opção para obter requisições de casos de endpoint predeterminados que já contêm parâmetros configurados. Isso é especialmente útil para testes padronizados que simulam o uso real da API, permitindo consistência entre execuções de teste.
2.
Requisições independentes não associadas à especificação da API—Essas requisições não são atualizadas em resposta a mudanças na especificação da API. Elas permitem maior personalização:
a. Adicionar requisição personalizada: Crie requisições do zero para adaptar cenários de teste a requisitos específicos. Essa abordagem oferece flexibilidade máxima para explorar além dos limites da especificação de API existente.
b. Adicionar a partir de cURL: Usar cURL permite importar ou moldar requisições personalizadas com eficiência. É uma maneira prática de criar rapidamente requisições que imitam interações de API complexas ou exclusivas sem ficar restrito pela especificação da API.
3.
Referenciar outros cenários de teste:
a. Incluir requisições de outros cenários de teste: Este método permite importar requisições específicas de diferentes cenários de teste já definidos em seu projeto.
b. Referenciar outro cenário de teste: Para testes abrangentes, talvez você precise empregar a totalidade de outro cenário de teste. Esse recurso garante que você possa integrar todos os testes e configurações relacionados, evitando a necessidade de duplicar esforços de configuração e promovendo estratégias de teste unificadas.

Importar da especificação do endpoint#

Você pode importar especificações de endpoint do projeto atual como etapas no cenário de teste. Há dois modos ao importar endpoints: "Manual" e "Automated". Para obter instruções mais detalhadas, consulte Sincronizar dados de APIs/casos de API.
Manual
No modo "Manual", modificações na documentação do endpoint dentro do projeto não têm impacto imediato sobre os endpoints nas etapas de teste. A sincronização dos dados de teste ocorre somente quando os testadores ativam o botão "Manual". É importante observar que alterações feitas nos dados da etapa de teste não atualizarão a documentação do endpoint, mesmo ao clicar em "Manual Sync". Em vez disso, clicar nesse botão permite que os cenários de teste recuperem informações da documentação do endpoint para fins de sincronização.
Automated
No modo "Automated", quaisquer alterações na documentação do endpoint dentro do projeto serão atualizadas de forma síncrona nas etapas de teste.
Se você precisar testar endpoints de outros projetos em um cenário de teste, consulte Importar endpoints/casos de outros projetos para etapas de teste.

Importar de caso de endpoint#

Você pode optar por importar casos de endpoint do projeto atual ou de outros projetos. Há dois modos ao importar casos de endpoint: "Copy" e "Reference".
Copy
Ao importar um caso de endpoint como "Copy", os parâmetros no caso de endpoint também serão copiados para as etapas de teste. Eles serão independentes entre si, e alterações em cada um não afetarão os outros. A sincronização manual pode ser selecionada.
Reference
Ao importar um caso de endpoint como "Reference", ele usará diretamente o caso de endpoint do projeto original para a requisição.

Adicionar requisição personalizada#

Em um processo de trabalho, talvez você precise chamar um endpoint fora do projeto, como um endpoint de pagamento de terceiros.
Você pode adicionar uma requisição de API personalizada nas etapas de teste. A requisição personalizada pode ser qualquer requisição HTTP, incluindo as comuns GET, POST, PUT, DELETE etc.

Adicionar a partir de cURL#

Em processos de trabalho reais, muitas requisições de endpoint são apresentadas na forma de linhas de comando cURL. Você tem a opção de importar requisições cURL para as etapas de teste com apenas um clique.

Incluir etapas de outros cenários de teste#

Você pode clonar as etapas de teste ou as condições de controle de processo importando de outros cenários de teste dentro do mesmo projeto.

Referenciar outros cenários de teste#

Você pode referenciar outros cenários de teste como uma etapa de teste. Há dois casos de uso:
1.
Se o seu processo de negócios tiver algumas etapas comuns e reutilizáveis de teste de API, você pode compilar essas etapas em um pequeno cenário de teste e, em seguida, referenciá-lo diretamente em outros cenários de teste mais amplos.
2.
Se você precisar fazer a regressão do processo principal de todo o produto, poderá referenciar os vários subcenários de teste no cenário de teste para montagem e concluir o trabalho de regressão de teste de todos os processos principais com um clique.
Para evitar loops infinitos e situações em que o cenário de teste não consegue parar de executar normalmente, o recurso de referenciar outros cenários de teste não pode referenciar o próprio cenário de teste original.

Orquestrar o cenário de teste#

Clicar em qualquer etapa de teste abrirá o modo de orquestração. Nesse modo, você tem uma página de operação maior para preencher melhor e com mais eficiência o conteúdo detalhado de cada etapa de teste. O lado esquerdo da página mostra o fluxo geral do cenário de teste, e o lado direito mostra os detalhes da etapa de teste selecionada. Requisições de endpoint e componentes de controle do processo de teste terão painéis de exibição diferentes.
Você pode ajustar a ordem das etapas arrastando o ≡ na frente da etapa.
Você pode usar as teclas "⬆️" e "⬇️" para alternar rapidamente entre as etapas de teste selecionadas nesse modo.
No modo de orquestração, você pode editar várias etapas e, em seguida, clicar no botão "Save All" no canto superior esquerdo para salvar todas as alterações.
Se alguma etapa tiver alterações não salvas, ela será marcada com um ponto na barra de lista à esquerda. Lembre-se de sempre salvar as alterações que você fez.
Modified at 2026-06-11 10:21:25
Previous
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?
Next
Como passar dados entre etapas de teste?
Built with