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. Suíte de testes
  • Centro de Aprendizagem da Apidog
  • Primeiros passos
    • Introdução ao Apidog
    • Conceitos Básicos no Apidog
    • Navegar no Apidog
    • Início rápido
      • Visão geral
      • Criar um Endpoint
      • Fazer um Pedido
      • Adicionar uma asserção
      • Criar Cenários de Teste
      • Partilhar Documentação da API
      • Explore Mais
    • Migração para o Apidog
      • Visão geral
      • Importação Manual
      • Importação Agendada (Vincular Fontes de Dados)
      • Opções de Importação
      • Exportar Dados
      • Importar de
        • Importar do Postman
        • Importar especificação OpenAPI
        • Importar cURL
        • Importar Markdowns
        • Importar a partir do Insomnia
        • Importar a partir de apiDoc
        • Importar Ficheiro .har
        • Importar WSDL
  • Apidog Europe
    • Apidog Europe
  • Dados de API mock
    • Visão geral
    • Smart Mock
    • Mock personalizado
    • Sequência de Prioridade do Mock
    • Scripts de Mock
    • Mock na Cloud
    • Mock do Runner Autoalojado
    • Idioma de Mock (Localidades)
  • Conta e preferências
    • Definições da Conta
    • Gerar um Token de Acesso OpenAPI
    • Notificações
    • Definições de Idioma
    • Teclas de Atalho
    • Configuração de Proxy de Rede
    • Cópia de Segurança dos Dados
    • Atualizar o Apidog
    • Eliminar Conta
    • Funcionalidades Experimentais
  • Enviar requisições
    • Visão geral
    • Depuração de SSE
    • Cliente MCP
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP ou WebService
    • GraphQL
    • gRPC
    • Utilizar Agentes de Proxy de Pedido para Depuração
    • Criar requisições
      • Histórico de Pedidos
      • Noções Básicas de Pedidos
      • Parâmetros e Corpo
      • Cabeçalhos do Pedido
      • Definições do Pedido
      • Depurar Pedidos
      • Guardar Pedidos como Endpoints
      • HTTP/2
    • Autenticação e autorização
      • Visão geral
      • Certificados CA e de Cliente
      • Tipos de autorização
      • Autenticação Digest
      • OAuth 1.0
      • OAuth 2.0
      • Autenticação Hawk
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • Resposta e cookies
      • Visualizar Respostas de API
      • Gerir Cookies
      • Visão geral
  • Desenvolver e depurar APIs
    • Visão geral
    • Gerar Pedidos
    • Enviar Pedidos
    • Casos de Depuração
    • Casos de Teste
    • Valores Dinâmicos
    • Validação de Respostas
    • Design-First vs Request-First
    • Geração de Código
    • Ambientes e variáveis
      • Visão geral
      • Utilizar Variáveis
      • Gestão de Ambientes
    • Segredos do cofre
      • Visão geral
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • Módulos de valores dinâmicos
      • Airline
      • Animal
      • Cor
      • Comércio
      • Empresa
      • Base de Dados
      • Tipo de dados
      • Data
      • Finanças
      • Alimentação
      • Git
      • Hacker
      • Helpers
      • Imagem
      • Internet
      • Localização
      • Lorem
      • Música
      • Número
      • Pessoa
      • Telefone
      • Ciência
      • String
      • Sistema
      • Veículo
      • Word
    • Pré e pós-processadores
      • Visão geral
      • Asserção
      • Extrair variável
      • Espera
      • Segurança
      • Operações de banco de dados
        • Visão geral
        • MySQL
        • MongoDB
        • Redis
        • Cliente Oracle
      • Uso de scripts
        • Visão geral
        • Scripts de Pré-processamento
        • Scripts de pós-processamento
        • Scripts Públicos
        • Referência de Scripts do Postman
        • Chamar Outras Linguagens de Programação
        • Utilizar Bibliotecas JS
        • Visualizar Respostas
        • Exemplos de scripts
          • Scripts de Asserção
          • Utilização de Variáveis
          • Modificar Pedidos
          • Outros exemplos
    • Depuração de APIs
      • Depurador de Agentes de IA
      • Depurador A2A
  • Projetar APIs
    • Visão geral
    • Criar um Novo Projeto de API
    • Noções Básicas de Endpoints
    • Diretrizes de Design de API
    • Módulo
    • Configurar vários exemplos de corpo do pedido
    • Componentes
    • Campos Comuns
    • Parâmetros Globais
    • Histórico de Alterações do Endpoint
    • Comentários
    • Gestão de Endpoints em Lote
    • API de Protocolo Personalizado
    • Modo Spec-first (Beta)
    • Esquemas de segurança
      • Visão geral
      • Criar um Esquema de Segurança
      • Utilizar o Esquema de Segurança
      • Esquema de Segurança na Documentação Online
    • Recursos avançados
      • Campos de Endpoint Personalizados
      • Cenários de Teste Associados
      • Estado do endpoint
      • Aparência das listas de parâmetros
      • Identificação Única de Endpoint
    • Schemas
      • Visão geral
      • Criar um Novo Schema
      • Criar um Schema
      • Gerar esquemas a partir de JSON, etc.
      • oneOf, allOf, anyOf
      • Utilizar Discriminator
  • Testes de API
    • Visão geral
    • Cenários de teste
      • Criar um Cenário de Teste
      • Passar Dados Entre Pedidos
      • Condições de Controlo de Fluxo
      • Sincronizar Dados de Endpoints e Casos de Endpoint
      • Importar Endpoints e Casos de Endpoint de Outros Projetos
      • Exportar Cenários de Teste
    • Relatórios de teste
      • Relatórios de Teste
    • Executar cenários de teste
      • Executar um cenário de teste
      • Executar cenários de teste em lote
      • Testes Orientados por Dados
      • Dados de Teste Partilhados
      • Tarefas agendadas
      • Gerir o ambiente de runtime de APIs de outros projetos
    • Suíte de testes
      • Visão geral
      • Criar Uma Suite de Testes
      • Orquestrar Conjunto de Testes
      • Executar Conjuntos de Testes Localmente
      • Executar conjuntos de testes via CLI
      • Tarefas agendadas
    • Testar APIs
      • Testes de Integração
      • Testes de desempenho
      • Testes de Ponta a Ponta
      • Teste de regressão
      • Testes de Contrato
    • Apidog CLI
      • Visão geral
      • Instalar e Executar o Apidog CLI
      • Opções da CLI do Apidog
    • CI/CD
      • Visão geral
      • Integrar com o Github Actions
      • Integrar com o Gitlab
      • Integrar com Jenkins
      • Acionar Teste por Commit Git
  • Publicar documentação de API
    • Visão geral
    • Tecnologias de API Suportadas
    • Partilha Rápida
    • Visualizar a Documentação da API
    • Documentação Markdown
    • Publicar Sites de Documentação
    • Página de Início de Sessão Personalizada
    • Layouts personalizados
    • CSS, JavaScript, HTML personalizados
    • Domínio Personalizado
    • Funcionalidades de IA
    • Definições de SEO
    • Configurações avançadas
      • Pesquisa na Documentação
      • Proxy CORS
      • Integrar o Google Analytics
      • Definições da Árvore de Pastas
      • Definições de Visibilidade
      • Incorporar Valores em URLs de Documentação
    • Versões da API
      • Visão geral
      • Criar Versões de API
      • Publicar versões de API
      • Partilhar Endpoints com Versões da API
  • Branches
    • Visão geral
    • Criar uma Branch de Sprint
    • Testar APIs numa Branch
    • Conceber APIs numa Ramificação
    • Mesclar Branches de Sprint
    • Gerir Branches de Sprint
    • AI Branch (Beta)
  • Recursos de IA
    • Visão geral
    • Ativar Funcionalidades de IA
    • Gerar Casos de Teste
    • Modificar esquemas com IA
    • Verificação de Conformidade do Endpoint
    • Verificação da Completude da Documentação da API
    • Nomeação de Campos com IA
    • Perguntas frequentes
  • Servidor MCP do Apidog
    • Visão geral
    • Ligar o Projeto Apidog à IA
    • Ligar Documentação Publicada à IA
    • Ligar Ficheiros OpenAPI à IA
  • Boas práticas
    • Tratamento de Assinaturas de API
    • Aceder a APIs Protegidas por OAuth 2.0
    • Fluxo de trabalho de colaboração
    • Gestão do Estado de Autenticação
  • Espaço offline
    • Visão geral
  • Administração
    • Gerenciamento de projetos
      • Gerir Projetos
      • Definições de Notificação
      • Gerir Membros do Projeto
      • Recursos do projeto
        • Ligação à Base de Dados
        • Ligação Git
    • Gerenciamento de equipes
      • Gerir Equipas
      • Gerir Membros da Equipa
      • Atividades da Equipa
      • Funções e permissões da equipa
      • Recursos da equipe
        • General Runner
        • Variáveis de Equipa
        • Agente Proxy de Pedidos
      • Colaborações em tempo real
        • Colaboração em Equipa
    • Checklist de integração
      • Conceitos Básicos
      • Guia de Integração Inicial
    • Gerenciamento da organização
      • Gerir a Organização
      • Funções e Permissões da Organização
      • Gerenciamento de planos
        • Gestores de Faturação em Organizações
      • Single Sign-On (SSO)
        • Visão Geral do SSO
        • Configurar o Microsoft Entra ID
        • Configurar o Okta
        • Configurar SSO para uma organização
        • Gerir Contas de Utilizador
        • Mapear Grupos para Equipas
      • Provisionamento SCIM
        • Introdução ao Provisionamento SCIM
        • Microsoft Entra ID
        • Okta
      • Recursos da organização
        • Self-Hosted Runner
  • Cobrança
    • Visão geral
    • Créditos
    • Atualizar o seu plano
    • Métodos de Pagamento Alternativos
    • Gestão de Subscrições
    • Mover Equipas Pagas para Organizações
  • Complementos
    • API Hub
    • Plugin Apidog Intellij IDEA
    • Extensão do navegador
      • Chrome
      • Microsoft Edge
    • Proxy de requisições
      • Proxy de pedidos na Web
      • Proxy de Pedidos em Documentação Partilhada
      • Proxy de Pedido no Cliente
  • Dados e segurança
    • Armazenamento e Segurança de Dados
    • Privacidade e Segurança dos Dados do Utilizador
    • Encaminhamento de Pedidos e Segurança dos Dados
  • Referências
    • Abordagem API Design-First
    • Extensões da Especificação OpenAPI do Apidog
    • JSONPath
    • XPath
    • Expressões Regulares
    • JSON Schema
    • Formato de ficheiro CSV
    • Instalar o Ambiente Java
    • Ambiente de Implementação do Runner
    • Sintaxe Markdown do Apidog
    • Extensões Swagger do Apidog
      • Visão geral
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Extensões JSON Schema do Apidog
      • Visão geral
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • Central de suporte
  1. Suíte de testes

Orquestrar Conjunto de Testes

Depois de criar um conjunto de testes, precisa de adicionar conteúdo de teste. O Apidog fornece modos flexíveis "Estático" e "Dinâmico" para satisfazer diferentes necessidades de gestão de testes.

Importar Conteúdo de Teste#

Na página de detalhes do conjunto de testes, no separador Orchestration, clique em + Add Endpoint Test Case ou + Add Test Scenario. Na janela pop-up de seleção, pode alternar entre o modo Static ou Dynamic.
image.png

1. Modo Estático#

O modo Estático é utilizado para especificar com precisão os itens de teste a executar.
🎯 Lógica Principal
O sistema regista os IDs dos casos de teste específicos que selecionar. Mesmo que sejam adicionados novos casos de teste à categoria de origem, o âmbito de execução deste conjunto não será alterado, garantindo a controlabilidade dos resultados dos testes.
🚀 Melhores Cenários de Utilização
Verificação de Correção de Erros (Hotfix): Selecione 3 a 5 casos de teste fortemente relacionados com o erro, forme um "pacote de verificação" e verifique rapidamente o resultado da correção, sem perder tempo a executar casos não relacionados.
Estabilização do Negócio Principal (Core Path): Para processos extremamente centrais e estáveis, como "encomenda-pagamento". Não queremos que sejam acionados alertas de monitorização porque um recém-chegado adicionou acidentalmente um caso de teste incompleto.
Teste de Compatibilidade de Versões Antigas: Selecione um lote de casos de teste de endpoints antigos especificamente para verificar a compatibilidade de clientes de versões antigas.
⚠️ Características de Manutenção
Custo de Manutenção Elevado: Se for necessário incluir novos casos neste teste especializado, estes têm de ser adicionados manualmente.

2. Modo Dinâmico#

O modo Dinâmico é utilizado para filtrar automaticamente, através de regras, os itens de teste a executar.
🎯 Lógica Principal
O sistema guarda "Regras de Filtro" (Âmbito e Filtro). Sempre que é executado, o sistema analisa todo o projeto em tempo real e inclui no plano de execução todos os casos mais recentes que cumpram os critérios.
🚀 Melhores Cenários de Utilização
Teste de Regressão ao Nível do Módulo: Defina a pasta "Centro de Negociação" como pasta de origem. Os testers apenas precisam de escrever novos casos na pasta, e o conjunto irá incluí-los automaticamente quando for executado.
Teste de Smoke: Crie um conjunto dinâmico com a regra Priority = P0. Execute antes de cada lançamento para cobrir automaticamente todos os casos principais marcados como P0.
Verificação de Iteração de Versão: Utilize a funcionalidade de etiquetas e defina a regra como Tag = v2.5.0. Após a conclusão do desenvolvimento, execute este conjunto para verificar todas as novas funcionalidades desta versão.
⚠️ Características de Manutenção
Custo de Manutenção Zero: Depois de configuradas as regras, não é necessário manter o próprio conjunto posteriormente; apenas é necessário manter os atributos dos casos (localização, etiquetas, prioridade).

Ajustar a Ordem de Execução#

O conteúdo importado será apresentado numa lista, e pode arrastar os itens da lista para ajustar a ordem de execução.
Para itens adicionados "estaticamente", pode utilizar Edit para eliminar casos de teste individualmente ou eliminar todo o grupo.
image.png
Para grupos adicionados "dinamicamente", só pode eliminar todo o grupo ou editar os critérios de filtro, não podendo eliminar itens individuais dentro do grupo.
image.png

Configuração Avançada#

No lado direito da página de design do conjunto de testes, pode expandir Advanced Config para ter um controlo mais granular sobre a forma como o conjunto de testes é executado.
image.png
image.png

Ambiente#

Definição: Por predefinição, herda o ambiente de execução já definido no conjunto de testes. Se for especificado aqui um ambiente, essa configuração de ambiente terá prioridade durante a execução.
Caso de Utilização: Adequado para cenários em que precisa de reutilizar o mesmo conjunto de passos de teste em diferentes ambientes.

Dados de Teste#

Utilizado para especificar se devem ser utilizados dados de teste durante a execução.
Sem Dados de Teste: Os passos de teste são executados apenas uma vez, sem executar testes orientados por dados.
Utilizar Dados de Teste: Executar várias vezes com base nos dados de teste, normalmente utilizado para testes parametrizados.

Em Caso de Erro#

Configure como o teste deve lidar com erros, que podem incluir falhas de asserção, falhas de validação de formato de dados, exceções de pedidos de endpoint, erros do servidor, etc.
Ignorar: Continuar a executar os passos subsequentes quando ocorre um erro, sem interromper a execução atual.
Continuar: Quando ocorre um erro, ignorar os passos restantes da ronda atual e entrar diretamente na ronda de execução seguinte.
Terminar execução: Terminar imediatamente os passos subsequentes assim que ocorre um erro.

Iterações#

Definição: O número de vezes que cada thread percorre todos os passos em ciclo.
Caso de Utilização: Normalmente utilizado para verificação de estabilidade ou cenários simples de teste de esforço.

Atraso#

Definição: Defina quantos milissegundos (ms) aguardar após a conclusão de cada passo de teste antes de executar o passo seguinte.
Caso de Utilização: Impedir o acionamento de mecanismos de limitação de taxa ou de circuit breaker no servidor de destino devido a uma elevada frequência de pedidos, garantindo uma execução de testes fluida.

Guardar Pedidos/Respostas#

Definição: Controlar se o relatório de teste inclui dados detalhados de pedidos e respostas (como Cabeçalho, Corpo, etc.).
Opções:
Todos: Guardar os detalhes completos de todos os passos, independentemente de passarem/falharem. Grande volume de dados, adequado para depuração aprofundada.
Apenas Falhados: Guardar apenas os detalhes dos passos que falharam durante a execução. Recomendado, poupa espaço de armazenamento e facilita a identificação rápida dos motivos de falha.
Não Guardar: Não guardar quaisquer detalhes; registar apenas o estado de aprovação/falha e a duração.

Valores de Variáveis de Ambiente/Globais#

Os valores de variáveis de ambiente/globais especificam quais os valores reais a utilizar para variáveis de ambiente/globais neste cenário de teste. Existem duas opções. Informações detalhadas podem ser consultadas aqui. Ao optar por utilizar valores de variáveis guardados no Runner, ser-lhe-á pedido que selecione adicionalmente o âmbito de variáveis a utilizar.
A finalidade deste âmbito é ajudar os utilizadores a separar melhor as variáveis de acordo com as necessidades reais, evitando situações em que a execução de uma tarefa agendada faça com que outras tarefas falhem devido a alterações de variáveis. Depois de selecionar o âmbito, também pode visualizar os valores das variáveis dentro deste âmbito através da entrada que aparece na interface do produto.
Âmbito de Variáveis no RunnerLer/Escrever Variáveis de Ambiente/GlobaisDescrição
Partilhar apenas no cenário de teste atual
  • No Runner especificado atual, este cenário de teste tem um ficheiro dedicado para armazenar persistentemente as suas variáveis de ambiente/globais.
  • Apenas o cenário de teste atual pode ler e escrever variáveis neste ficheiro.
O menor âmbito de variáveis, com impacto mínimo. Adequado para casos em que os resultados da execução anterior deste cenário de teste precisam de ser utilizados na execução seguinte.
Os ficheiros de variáveis para cenários de teste, tarefas e pastas de tarefas são todos guardados no caminho do contentor Runner /opt/runner/variables.
Partilhar entre todos os cenários de teste na tarefa agendada atual
  • No Runner especificado atual, a tarefa agendada tem um ficheiro para armazenar variáveis de ambiente/globais que podem ser utilizadas em todos os seus cenários de teste.
  • Todos os cenários de teste na tarefa agendada atual podem ler e escrever variáveis neste ficheiro.
Um âmbito de variáveis recomendado, com impacto moderado. Adequado para casos em que os dados precisam de ser partilhados entre diferentes cenários de teste dentro da mesma tarefa agendada.
Partilhar entre todas as tarefas agendadas na pasta da tarefa agendada atual
  • No Runner especificado atual, a pasta da tarefa agendada tem um ficheiro para armazenar variáveis de ambiente/globais que podem ser utilizadas em todas as suas tarefas agendadas e cenários de teste.
  • Todos os cenários de teste em todas as tarefas agendadas dentro da pasta atual podem ler e escrever variáveis neste ficheiro.
O maior âmbito de variáveis, com o impacto mais significativo. É possível que a execução de uma determinada tarefa agendada modifique o valor da variável, levando à falha de outras tarefas agendadas. Adequado quando os dados precisam de ser partilhados entre várias tarefas na mesma pasta.
Modified at 2026-06-09 08:54:45
Previous
Criar Uma Suite de Testes
Next
Executar Conjuntos de Testes Localmente
Built with