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

Quais são as diferenças entre sincronizar dados de endpoints/casos de endpoint?

Para passos de teste importados de endpoints/casos de endpoint, os respetivos dados de pedido podem ser sincronizados com a especificação/casos de endpoint associados.
Sincronizar dados
Ao importar endpoints/casos de endpoint para passos de teste, pode escolher o modo Manual ou Automatizado.
O modo Manual é adequado para cenários em que várias pessoas colaboram, o que significa que, num projeto, os processos de especificação, desenvolvimento e teste do endpoint têm todos uma divisão clara de trabalho e cada processo tem uma pessoa dedicada responsável. Estes processos requerem independência dos dados para evitar que alterações não intencionais se afetem mutuamente. Depois de garantir a estabilidade dos dados da especificação/caso de endpoint, o responsável pelos testes pode sincronizá-los manualmente com os passos de teste.
O modo Automatizado é adequado para pequenas equipas ou programadores independentes, o que significa que, num projeto, os processos de especificação, desenvolvimento e teste do endpoint são todos tratados por uma única função, melhorando a eficiência da manutenção e dos testes do endpoint. Quando os endpoints/casos de endpoint em "Gestão de Endpoints" mudam, os dados do endpoint/caso de endpoint nos passos de teste também serão ajustados em conformidade, garantindo a consistência dos dados entre "Gestão de Endpoints" e "Testes Automatizados".
Modo de sincronização

Relação de sincronização#

Método de importação do passo de testeDados associadosModo de sincronização do passo de testeConteúdo da sincronização
Importado de endpoint - Modo manualEspecificação do EndpointModo manual (clique no botão "Atualizar" nos passos de teste)✅ Alterações em "nome do parâmetro", "Path", "Method", "pré/pós-ações", etc.

❌ "Valores dos parâmetros".
Importado de endpoint - Modo automatizadoEspecificação do EndpointModo automatizado (quando a especificação do endpoint é atualizada e guardada)✅ Alterações em "nome do parâmetro", "Path", "Method", "pré/pós-ações", etc.

❌ "Valores dos parâmetros".
Importado de caso de endpoint - CopiarEspecificação do EndpointModo manual (clique no botão "Atualizar" nos passos de teste)✅ Alterações em "nome do parâmetro", "Path", "Method", "pré/pós-ações", etc.

❌ "Valores dos parâmetros".
Importado de caso de endpoint - ReferênciaCaso de EndpointModo automatizado (quando o caso de endpoint é atualizado e guardado)✅ Referencia os dados do caso de endpoint; quaisquer alterações no caso de endpoint afetarão o conteúdo deste passo de teste.

Modo de sincronização manual#

Quando o modo Manual é selecionado, o botão associado aparece a "azul". Quando existem alterações na especificação do endpoint na "Gestão de Endpoints", os dados nos passos de teste não serão atualizados em tempo real. Os responsáveis pelos testes podem clicar manualmente no botão "Atualizar" nos detalhes dos "Passos de Teste" para sincronizar as alterações dos endpoints/casos de endpoint com os passos de teste.
Este modo é adequado para cenários de teste em que os responsáveis pelos testes têm um grande número de pedidos para ajuste fino dos parâmetros de pedido, evitando influências não intencionais nestes dados de teste e garantindo o isolamento entre os dados de teste e os dados dos endpoints em desenvolvimento.
Sincronização manual
Sincronizar dados
No modo Manual, o menu pendente do botão associado também suporta a filtragem manual do âmbito da sincronização de dados.
Filtrar sincronização

Sincronizar especificações de endpoint#

Para passos de teste gerados ao importar Endpoint → Manual update ou ao importar a partir de um caso de endpoint → Copiar, o conteúdo associado é a especificação do endpoint. Estes passos de teste podem ser sincronizados com o conteúdo da especificação do endpoint clicando no botão "Sincronizar agora" na página.
Depois de acionar uma sincronização manual, o passo de teste sincronizará dados a partir da especificação do endpoint, incluindo "nome do parâmetro", "pré/pós-scripts", etc. Tenha em atenção que o objeto de sincronização é a especificação do endpoint e, se os parâmetros de pedido na especificação do endpoint não tiverem valores de exemplo definidos, o conteúdo sincronizado não incluirá "valores dos parâmetros".
Guardar e atualizar os dados em "Especificação do Endpoint" não afetará os passos de teste associados.
Sincronizar especificação de endpoint
Clicar no botão "Atualizar" no passo de teste acionará o mecanismo de sincronização de dados, e o botão indicará "Sincronizado". Depois de confirmar que os dados sincronizados estão corretos, tem de clicar no botão "Guardar" no canto superior direito para guardar o passo de teste.
Guardar sincronização

Sincronizar dados em lote#

Se a maioria dos dados nos passos de teste atuais estiver a utilizar o modo Manual e o responsável pelos testes tiver confirmado que os dados nestas especificações/casos de endpoint estão corretos e pretender sincronizar rapidamente os dados com os passos de teste, pode clicar no botão "Atualizar" na página de passos de teste para realizar uma operação de sincronização em lote.
Sincronização em lote

Modo de sincronização automatizado#

O botão associado aparecerá a laranja. Como mencionado anteriormente, este modo ajuda programadores individuais a controlar o fluxo e a acompanhá-lo por si próprios.
Sincronização automatizada

Sincronizar especificações de endpoint#

Para passos de teste associados à especificação do endpoint, quando o modo de sincronização está definido como Sincronização Automática, se existirem alterações na especificação do endpoint e esta for guardada, os dados serão atualizados em tempo real no passo de teste. O conteúdo sincronizado é consistente com o modo de sincronização Manual descrito anteriormente.
Sincronização automática de endpoints
No modo Automatizado, quaisquer inconsistências entre os dados no passo de teste e a especificação do endpoint serão destacadas. Os responsáveis pelos testes podem escolher "Reverter" para manter a consistência total com a especificação do endpoint, ou podem escolher "Guardar no Documento", o que substituirá os dados na especificação do endpoint pelos dados do passo de teste para manter a consistência.
Destacar discrepâncias

Sincronizar casos de endpoint#

Para garantir consistência e unicidade na gestão de dados de casos de endpoint que são referenciados em passos de teste, os ajustes devem ser efetuados no caso de endpoint referenciado no sistema de "Gestão de Endpoints", para que tanto os casos de endpoint como os passos de teste utilizem os mesmos dados de pedido.
Depois de clicar no botão "Editar" na instrução na página do passo de teste, será encaminhado para a página do caso de endpoint associado para efetuar ajustes. O passo de teste sincronizará automaticamente os dados após as alterações ao caso de endpoint, incluindo "nome do parâmetro", "valor do parâmetro", "pré/pós-scripts" e todo o restante conteúdo do pedido.
Sincronizar casos de endpoint
Modified at 2026-06-09 08:54:45
Previous
Como utilizar o ciclo foreach no Apidog?
Next
Como utilizar dados de teste no Apidog?
Built with