Automação e testes

Quando uma requisição já funciona, coloque-a para trabalhar por você. O Echo automatiza as tarefas repetitivas: executar conjuntos de testes, encadear chamadas, simular dependências e verificar uma API em horários definidos.

Execute uma coleção inteira

O executor de coleções percorre uma coleção do início ao fim:

  1. Escolha a coleção e defina o número de iterações.
  2. Acrescente um intervalo entre requisições se a API de destino precisar de uma pausa.
  3. Ative a interrupção em caso de erro se uma falha tiver que parar a execução.
  4. Inicie a execução e acompanhe os resultados em tempo real.

O executor ajuda a verificar uma API depois de uma implantação ou a reproduzir uma falha em várias iterações. Carregue um arquivo CSV com cabeçalhos de coluna ou um array JSON de objetos para executar a coleção com entradas diferentes. Cada linha fornece os valores de uma iteração.

Ao terminar, exporte um relatório JUnit XML para suas ferramentas de teste ou um relatório HTML para ler e compartilhar. O histórico guarda o nome do arquivo de dados e a quantidade de linhas, para você identificar como a execução foi preparada.

Encadeie requisições sem código

As cadeias de requisições são declarativas e não precisam de scripts. Cada cadeia executa as etapas na ordem definida, extrai valores de uma resposta com JSONPath e os passa às etapas seguintes. Entrar na conta, obter o token, criar um recurso e verificá-lo podem fazer parte da mesma cadeia.

As etapas também podem ter condições, para que a cadeia siga caminhos diferentes de acordo com a resposta real da API.

Escolha onde o mock é executado

Quando uma dependência real ainda não está pronta, um mock permite que a equipe de frontend continue trabalhando e teste tempos de espera e códigos de erro. O Echo identifica rotas por padrões de caminho, aceita respostas estáticas ou por contrato e permite definir o atraso e o status de cada rota.

O desktop pode interceptar requisições enviadas dentro do Echo em qualquer plano, incluindo o Free. Para obter uma URL que outra aplicação ou pessoa possa chamar, publique um mock sincronizado no painel de hospedagem pública do Maestro, disponível no Echo Pro e Pro AI. Nesse plano você publica um mock do seu próprio espaço; para publicar um mock de equipe precisa da permissão Echo/ManageHosting. Um mock publicado continua respondendo sem o desktop aberto. Consulte hospedagem pública de mocks para conhecer as etapas de publicação, o acesso pela URL pública e os controles operacionais.

Para usar regras dentro da sua aplicação .NET, utilize Mock.Client ou Mock.Server e uma chave de aplicação com ServeMocks. É um caminho diferente da URL da hospedagem pública, mas o feed de regras também faz parte do Echo Pro e Pro AI.

Os mocks do desktop também aceitam respostas gRPC e sequências de mensagens WebSocket. Eles respondem às requisições feitas dentro do Echo. Não abrem uma porta de rede nem fornecem um endereço gRPC ou WebSocket para outra aplicação; a hospedagem pública de mocks atende requisições HTTP.

Verifique contratos além das respostas

Um contrato descreve a estrutura dos dados que uma aplicação fornece ou consome. Publique versões e compare a compatibilidade na direção relevante para sua aplicação. Os pacotes Contracts e Testing conectam a publicação e a validação à automação .NET.

Agende execuções

Escolha onde cada agendamento será executado. Os agendamentos do desktop precisam que o Echo fique aberto. Os agendamentos hospedados executam nos servidores da Gapfy e continuam depois que você fecha o aplicativo; eles exigem um plano pago do Echo e permissão para usar essa função.

O modo hospedado aceita requisições HTTP e operações query e mutation do GraphQL, com intervalo mínimo de cinco minutos entre execuções. Escolha o ambiente, salve o agendamento e confira se o Echo confirmou o agendamento no servidor. Sincronizar um agendamento do desktop não muda seu modo de execução. No Maestro, você pode consultar os resultados dos agendamentos hospedados e os resumos sincronizados das execuções de coleções.

Use scripts quando precisar

Para os casos que exigem mais do que cadeias declarativas, o Echo oferece JavaScript antes e depois da requisição com a API pm.*, incluindo asserções. Se você já escreveu scripts no Postman, a abordagem é familiar: verifique códigos de status, corpos e cabeçalhos das respostas e faça a execução falhar quando o resultado não corresponder ao esperado.

Comece pelas cadeias, que são mais fáceis de ler e manter, e use scripts quando precisar de lógica personalizada.

Próximos passos