Apidog Docs
🇵🇹 Português (Portugal)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇵🇹 Português (Portugal)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇵🇹 Português (Portugal)
  • 🇺🇸 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 da 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 automaticamente endpoints na importação de Swagger/OpenAPI?
  • Envio de requisições
    • O Apidog suporta Socket.IO?
    • Porque é que o "+" no valor do parâmetro é descodificado como um espaço?
    • Como enviar um pedido no Apidog?
    • Como enviar um pedido GraphQL no Apidog?
    • Como enviar um pedido gRPC no Apidog?
    • Como enviar um pedido SOAP/WebService no Apidog?
    • Como enviar um pedido WebSocket no Apidog?
    • O Apidog suporta scripts pré-pedido/teste e asserções em APIs WebSocket?
    • Como enviar um pedido SSE no Apidog?
    • Como adicionar cabeçalhos predefinidos ao nível da pasta?
    • O Apidog suporta scripts pré-pedido/de teste e asserções em APIs gRPC?
    • Erro do resolvedor DNS ELANREFUSED.DNS
    • Porque estou a receber um erro "socket hang up" ao enviar um pedido?
    • Correção de erros de requisição
      • Corrigir o erro read ECONNRESET
      • Corrigir o erro ECONNREFUSED
      • Corrigir o erro ETIMEDOUT
      • Corrigir o erro ENOTFOUND: Couldn't resolve host
      • Corrigir ENOTFOUND: getaddrinfo ENOTFOUND www Error
      • Corrigir o erro connect EHOSTUNREACH
  • Projeto de APIs
    • Como utilizo variáveis no caminho?
    • Posso utilizar um componente de resposta como resposta predefinida?
    • Como verificar quem modificou um endpoint?
    • Como posso eliminar 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 Esquemas?
    • Se uma propriedade de string tiver vários valores enumerados e for utilizada em vários locais, como é que este enum pode ser referenciado de forma consistente em todo o lado?
    • Como obter o ID da pasta de recursos do Apidog?
    • Como posso obter o ID da pasta de recursos do Apidog?
    • Como utilizo variáveis num caminho de URL?
    • O que deve fazer se um endpoint, documento ou cenário de teste for eliminado acidentalmente?
    • O Apidog suporta código de pedido para endpoints personalizados?
    • Como agrupar automaticamente endpoints ao importar Swagger/OpenAPI para o Apidog?
    • Como gero dados de array não duplicados em respostas mock?
    • Porque é que a entrada "#" não é suportada no caminho?
  • Depuração de APIs
    • Como é que o Apidog se integra com sistemas de gestão de chaves de terceiros?
    • Porque é que o mesmo pedido funciona corretamente noutras ferramentas (como o Postman), mas não no Apidog?
    • Como obter valores de variáveis a partir da base de dados no Apidog?
    • Como migrar ambientes de outras ferramentas para o Apidog?
    • Como criar asserções utilizando scripts no Apidog?
    • JSONPath só consegue extrair arrays. Como podemos extrair um único elemento dentro deles no Apidog?
    • Como configurar operações de base de dados no Apidog quando diferentes ambientes têm diferentes credenciais de conta da base de dados?
    • Como obter o URL base do serviço num script personalizado?
    • Porque é que o Apidog comunica um erro de excesso do comprimento máximo de string do Node.js quando a resposta da API é demasiado grande?
    • Qual é o limite de tamanho para a impressão na consola? Porque recebo um erro ao imprimir ficheiros grandes?
    • Como resolver erros de ligação à base de dados DB2 no Windows?
    • Porque estou a obter o erro NJS-045 ao ligar-me a uma base de dados Oracle no Apidog?
    • Como gerar valores dinâmicos em scripts personalizados do Apidog?
    • Porque é que o pedido do cliente para o mesmo endpoint é bem-sucedido, mas ocorre um erro ao depurar no lado web: "Não é possível solicitar o endereço"?
    • Porque é que o Apidog comunica um erro quando a resposta é demasiado grande?
    • Como posso utilizar 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 obtenho a baseURL do serviço num script personalizado?
    • Como posso visualizar o pacote original no Apidog?
    • Porque é que vejo o erro "Invalid URI xxx" ao fazer um pedido?
    • Como faço um pedido assíncrono num script do Apidog?
    • Porque vejo a mensagem "Couldn't resolve host" ao enviar um pedido?
    • Qual é o limite de tamanho de impressão na consola? Porque ocorre um erro ao imprimir um ficheiro grande?
    • Como faço para carregar um ficheiro num pedido de endpoint?
    • O que fazer se o Apidog falhar ou os dados da resposta não forem apresentados?
    • URI de Redirecionamento Oficial utilizado pelo Apidog para OAuth2.0
  • Dados de API mock
    • Como simular APIs automaticamente?
    • O que pode fazer o mocking do Apidog?
    • Como fazer mock de dados fixos de API no Apidog?
    • Como simular dados condicionais no Apidog?
    • Como ativar o mock na cloud no Apidog?
    • Como ativar o mock autoalojado no Apidog?
    • O Apidog suporta mocks de APIs WebSocket?
    • Porque é que o browser não devolve conteúdo ao solicitar o endpoint mock?
  • Testes automatizados
    • Porque é que os cenários de teste são executados sem problemas no meu cliente local, mas ocorrem erros ao executá-los na CLI ou no runner do Apidog?
    • Como criar um cenário de teste no Apidog?
    • Como passar dados entre etapas de teste?
    • Porque não consigo referenciar com êxito dados do passo anterior?
    • Como utilizar o ciclo foreach no Apidog?
    • Quais são as diferenças entre sincronizar dados de endpoints/casos de endpoint?
    • Como utilizar dados de teste no Apidog?
    • Como obter 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 um teste de desempenho no Apidog?
    • Como pode visualizar os pedidos e as respostas reais nos testes de desempenho?
    • Como posso exportar relatórios de testes de desempenho no Apidog?
    • Como utilizar resultados de consultas à base de dados como parâmetros para pedidos de API em loop?
    • Capturar e Validar 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 Contentor Docker do General Runner.
    • Como definir o host do servidor para o General Runner na versão Web do Apidog?
    • Porque é que o cenário de teste agendado terminou com 0 pedidos?
    • O que deve fazer se o parâmetro de carregamento de ficheiro não for encontrado no Runner ou na CLI?
    • Como utilizar o Runner para executar um cenário de teste com um passo de carregamento de ficheiro?
    • Como resolvo o erro "Error: unable to verify the first certificate on runner"?
    • Como pode aceder e pesquisar os logs do runner para identificar o problema quando surge um problema com um runner?
    • O que devo fazer se o parâmetro do endpoint for um ficheiro de upload e não puder ser encontrado no Runner ou na CLI?
    • Porque é que os passos de teste não são sincronizados automaticamente quando o caso de uso da API muda?
    • Porque é que a utilização de vários sinais de dólar num documento Markdown faz com que algum conteúdo não seja apresentado corretamente?
    • O Runner autoalojado gera um relatório de teste no servidor após executar uma tarefa?
    • Posso adicionar pré/pós-processadores unificados a pedidos num 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 logótipos da Apidog em documentos publicados?
    • Quando a especificação da API é atualizada, a documentação da API muda?
    • Como partilhar APIs com colaboradores no Apidog?
    • Como personalizar o domínio das documentações do Apidog?
    • Como criar documentação multiversão no Apidog?
    • Âmbito de partilha para Sites de Documentação Publicados no Apidog
    • Âmbito de partilha da lista Share Doc no Apidog
    • Porque é que a documentação partilhada publicada não mostra o hostname?
    • Como podem os utilizadores da documentação modificar a URL Base em documentação partilhada?
    • Posso duplicar um documento Apidog publicado para usar no meu próprio projeto?
    • Como Partilhar Cabeçalhos (por exemplo, Token) na Documentação Online do Apidog?
    • Porque é que o membro da minha equipa não consegue encontrar a documentação publicada?
    • Como corrijo a expiração de um certificado SSL ou um erro 526 da Cloudflare no meu domínio personalizado?
    • SMTP personalizado configurado com sucesso, mas os utilizadores na lista de permissões não recebem e-mails com OTP
  • Markdown
    • Como utilizar cartões para ligar a várias páginas ou endpoints dentro do Apidog?
    • Porque é que algum conteúdo não é apresentado corretamente ao utilizar vários símbolos $ em documentos Markdown?
    • Como utilizar imagens com fundo transparente no Markdown do Apidog?
    • Como definir a largura das colunas de uma tabela Markdown?
    • Como pode inserir APIs internas, documentos, esquemas de dados ou pastas num documento Markdown?
    • Como posso adicionar uma ligação a um documento ou endpoint dentro de um projeto num componente de cartão do Apidog?
  • Ramos
    • Como aceder ao branch de sprint?
  • Administração
    • Como instalar o cliente Apidog silenciosamente?
    • Porque estou a ver um erro “No Permission” apesar de ter acesso de administrador?
    • Como posso verificar o número da versão do runner?
    • O Apidog suporta Windows 7?
    • Porque é que o Apidog apresenta o erro "Cannot locate program entry point DiscardVirtualMemory in dynamic link library KERNEL32.dll" após a instalação?
    • Alterações de Subscrição e Reembolsos
    • Os pedidos Web funcionam, mas a aplicação apresenta "read ECONNRESET" — Porquê?
    • Porque não consigo abrir o Apidog após uma atualização do sistema Windows?
    • Porque é que o Apidog não abre após uma atualização do sistema Windows
  • Cobrança
    • Posso configurar uma conta de faturação separada para a minha equipa no Apidog?
    • Problemas de Acesso da Equipa e Faturação no Apidog
    • O membro da equipa convidado não consegue aceder ao Apidog.
    • Transferir uma Equipa Paga Pessoal para uma Organização
  • On-premises
    • Gestão de utilizadores e acessos na versão Self-Hosted (Enterprise) do Apidog
  • Web e cliente
    • Transferência e instalação da versão de ambiente de trabalho 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 para o módulo “Testes” e, em seguida, clique no + junto à barra de pesquisa para criar um novo cenário de teste. Selecione o diretório adequado para o mesmo e defina a prioridade para concluir a criação.

Adicionar passos de teste#

Depois de configurar o seu cenário de teste no Apidog, pode começar a preenchê-lo com pedidos. Existem várias formas de adicionar pedidos, cada uma adaptada a diferentes necessidades e níveis de flexibilidade:
1.
Pedidos associados à especificação da API—Estes pedidos podem ser atualizados à medida que a especificação da API muda:
a. Importar a partir da especificação do endpoint: Este método envolve a importação de pedidos diretamente a partir da definição estruturada na especificação da API. Garante que os seus testes estão alinhados com a interface documentada da API, embora possa ter de ajustar manualmente os parâmetros do pedido para cumprir condições de teste específicas.
b. Importar a partir do caso de endpoint: Utilize esta opção para obter pedidos a partir de casos de endpoint predefinidos que já contêm parâmetros configurados. Isto é particularmente útil para testes normalizados que simulam a utilização real da API, permitindo consistência entre execuções de teste.
2.
Pedidos independentes não associados à especificação da API—Estes pedidos não são atualizados em resposta a alterações na especificação da API. Permitem uma maior personalização:
a. Adicionar pedido personalizado: Crie pedidos de raiz para adaptar cenários de teste a requisitos específicos. Esta abordagem oferece a máxima flexibilidade para explorar além dos limites da especificação de API existente.
b. Adicionar a partir de cURL: Tirar partido do cURL permite-lhe importar ou moldar pedidos personalizados de forma eficiente. É uma forma prática de criar rapidamente pedidos que imitam interações de API complexas ou únicas, sem estar limitado pela especificação da API.
3.
Referenciar outros cenários de teste:
a. Incluir pedidos de outros cenários de teste: Este método permite-lhe importar pedidos específicos de diferentes cenários de teste já definidos no seu projeto.
b. Referenciar outro cenário de teste: Para testes abrangentes, pode ter de utilizar a totalidade de outro cenário de teste. Esta capacidade garante que pode 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 a partir da especificação do endpoint#

Pode importar especificações de endpoint do projeto atual como passos no cenário de teste. Existem dois modos ao importar endpoints: "Manual" e "Automatizado". Para obter instruções mais detalhadas, consulte Sincronizar dados de APIs/casos de API.
Manual
No modo "Manual", as modificações à documentação do endpoint no projeto não têm impacto imediato nos endpoints nos passos de teste. A sincronização dos dados de teste só ocorre quando os testadores ativam o botão "Manual". É importante notar que as alterações feitas aos dados do passo de teste não atualizarão a documentação do endpoint, mesmo ao clicar em "Sincronização manual". Em vez disso, clicar neste botão permite que os cenários de teste obtenham informações da documentação do endpoint para fins de sincronização.
Automatizado
No modo "Automatizado", quaisquer alterações na documentação do endpoint no projeto serão atualizadas de forma síncrona nos passos de teste.
Se precisar de testar endpoints de outros projetos num cenário de teste, consulte Importar endpoints/casos de outros projetos para passos de teste.

Importar a partir de caso de endpoint#

Pode optar por importar casos de endpoint do projeto atual ou de outros projetos. Existem dois modos ao importar casos de endpoint: "Copiar" e "Referência".
Copiar
Ao importar um caso de endpoint como "Copiar", os parâmetros no caso de endpoint também serão copiados para os passos de teste. Serão independentes entre si, e as alterações em cada um não afetarão os outros. A sincronização manual pode ser selecionada.
Referência
Ao importar um caso de endpoint como "Referência", este utilizará diretamente o caso de endpoint do projeto original para o pedido.

Adicionar pedido personalizado#

Num processo de trabalho, pode precisar de chamar um endpoint fora do projeto, como um endpoint de pagamento de terceiros.
Pode adicionar um pedido de API personalizado nos passos de teste. O pedido personalizado pode ser qualquer pedido HTTP, incluindo os comuns GET, POST, PUT, DELETE, etc.

Adicionar a partir de cURL#

Em processos de trabalho reais, muitos pedidos de endpoint são apresentados sob a forma de linhas de comando cURL. Tem a opção de importar pedidos cURL para os passos de teste com apenas um clique.

Incluir passos de outros cenários de teste#

Pode clonar os passos de teste ou as condições de controlo do processo importando a partir de outros cenários de teste dentro do mesmo projeto.

Referenciar outros cenários de teste#

Pode referenciar outros cenários de teste como um passo de teste. Existem dois casos de utilização:
1.
Se o seu processo de negócio tiver alguns passos de teste de API comuns e reutilizáveis, pode compilar estes passos num pequeno cenário de teste e depois referenciá-lo diretamente noutros cenários de teste mais amplos.
2.
Se precisar de efetuar a regressão do processo principal de todo o produto, pode recorrer aos 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 ciclos infinitos e situações em que o cenário de teste não consegue parar de executar normalmente, a funcionalidade 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 passo de teste entrará no modo de orquestração. Neste modo, dispõe de uma página de trabalho maior para preencher melhor e com mais eficiência o conteúdo detalhado de cada passo de teste. O lado esquerdo da página apresenta o fluxo geral do cenário de teste, e o lado direito apresenta os detalhes do passo de teste selecionado. Os pedidos de endpoint e os componentes de controlo do processo de teste terão painéis de apresentação diferentes.
Pode ajustar a ordem dos passos arrastando o ≡ à frente do passo.
Pode utilizar as teclas "⬆️" e "⬇️" para alternar rapidamente entre os passos de teste selecionados neste modo.
No modo de orquestração, pode editar vários passos e, em seguida, clicar no botão "Guardar tudo" no canto superior esquerdo para guardar todas as alterações.
Se algum passo tiver alterações não guardadas, o passo será assinalado com um ponto na barra de lista à esquerda. Lembre-se de guardar sempre as alterações que efetuou.
Modified at 2026-06-09 08:54:45
Previous
Porque é que os cenários de teste são executados sem problemas no meu cliente local, mas ocorrem erros ao executá-los na CLI ou no runner do Apidog?
Next
Como passar dados entre etapas de teste?
Built with