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. Cenários de teste
  • 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. Cenários de teste

Criar um Cenário de Teste

Um cenário de teste nos testes do Apidog serve como a unidade fundamental, análoga a uma Collection no Postman. Quando precisar de enviar vários pedidos consecutivamente, criar cenários de teste contínuos ou repetir pedidos com diferentes dados de teste, pode criar um cenário de teste e adicionar-lhe os pedidos necessários.

Vantagens dos Cenários de Teste#

Ao utilizar cenários de teste no Apidog, pode satisfazer eficientemente uma variedade de requisitos de teste de API:
FuncionalidadeDescrição
Execução Sequencial de PedidosOrganize e execute vários pedidos numa ordem especificada para simular interações de utilizadores ou fluxos de processos
Relatórios de TesteGere automaticamente relatórios que fornecem visualizações detalhadas das asserções e dos resultados de pedidos individuais
Integração CI/CDIntegre cenários de teste em pipelines CI/CD para garantir testes automáticos durante os ciclos de desenvolvimento, facilitando a deteção precoce de problemas
Testes de DesempenhoAvalie o desempenho da API sob cargas variáveis e gere análises de tendências para identificar alterações nos comportamentos de resposta ao longo do tempo
Teste de Parâmetros DinâmicosExecute pedidos várias vezes utilizando parâmetros gerados dinamicamente para testar como a API lida com entradas variáveis
Dados de Teste PredefinidosUtilize dados predefinidos para pedidos, de modo a simular condições de operação realistas e verificar as respostas da API em relação aos resultados esperados
Passagem de Dados Entre PedidosPasse automaticamente dados da saída de um pedido para outro, algo crucial para testar APIs que exigem persistência de estado entre chamadas
Relações Lógicas entre PedidosConfigure condições lógicas, como if, for e foreach, para gerir o fluxo de execução com base nos resultados de pedidos anteriores ou em condições específicas
Estas funcionalidades permitem-lhe criar ambientes de teste versáteis e eficazes que contribuem para um desenvolvimento de APIs robusto e de elevada qualidade.

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.
Criar um novo cenário de teste

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:

Pedidos Ligados à Especificação do Endpoint#

Estes pedidos podem ser atualizados à medida que a especificação do endpoint muda:

Importar da Especificação do Endpoint#

Pode importar especificações de endpoints do projeto atual como passos no cenário de teste. Existem dois modos ao importar endpoints: "Manual" e "Automatizado". Para instruções mais detalhadas, consulte Sincronizar dados a partir de endpoints/casos de endpoint.
Modo Manual
No modo "Manual", as modificações na documentação do endpoint dentro do projeto não têm um impacto imediato nos endpoints nos passos de teste. A sincronização dos dados de teste só ocorre quando os responsáveis pelos testes ativam o botão "Manual". É importante observar que as alterações efetuadas aos dados dos passos de teste não atualizam 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.
Modo Automatizado
No modo "Automatizado", quaisquer alterações na documentação do endpoint dentro do projeto serão atualizadas de forma síncrona nos passos de teste.
Modos Manual e Automatizado
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 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".
Modo 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 restantes. Pode selecionar a sincronização manual.
Modo Referência
Ao importar um caso de endpoint como "Referência", este utilizará diretamente o caso de endpoint do projeto original para o pedido.
Modos Copiar e Referência
Se o passo de teste for referenciado a partir de um caso, verá uma mensagem a indicar que modificar este passo também afetará o caso de endpoint original e quaisquer outros passos que o utilizem.
Mensagem de caso referenciado

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:

Adicionar Pedido Personalizado#

Num processo de trabalho, poderá 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 métodos 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.

Referenciar Outros Cenários de Teste#

Incluir Passos de Outros Cenários de Teste#

Pode clonar os passos de teste ou as condições de controlo do processo ao importar de outros cenários de teste dentro do mesmo projeto.
Incluir passos de outros cenários

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, em seguida, referenciá-lo diretamente noutros cenários de teste mais abrangentes.
2.
Se precisar de efetuar a regressão do processo principal de todo o produto, pode 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 consiga 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#

Ao clicar em qualquer passo de teste, entrará no modo de orquestração. Neste modo, tem uma página de operação maior para preencher melhor e de forma mais eficiente 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.
Visão geral do modo de orquestração
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 por guardar, o passo será marcado com um ponto na barra de lista à esquerda. Lembre-se de guardar sempre as alterações que efetuou.
Indicador de alterações por guardar
Modified at 2026-06-09 08:54:45
Previous
Visão geral
Next
Passar Dados Entre Pedidos
Built with