Automação e testes

Quando um pedido já funciona, põe-no a trabalhar por ti. O Echo automatiza as tarefas repetitivas: executar conjuntos de testes, encadear chamadas, simular dependências e verificar uma API segundo um horário.

Executa uma coleção inteira

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

  1. Escolhe a coleção e define o número de iterações.
  2. Acrescenta um intervalo entre pedidos se a API de destino precisar de uma pausa.
  3. Ativa a interrupção em caso de erro se uma falha tiver de parar a execução.
  4. Inicia a execução e acompanha os resultados em tempo real.

É uma forma rápida de verificar uma API depois de uma publicação ou de reproduzir uma falha intermitente ao longo de várias iterações.

Encadeia pedidos sem código

As cadeias de pedidos são declarativas e não precisam de scripts. Cada cadeia executa os passos pela ordem definida, extrai valores de uma resposta com JSONPath e passa-os aos passos seguintes. Iniciar sessão, obter o token, criar um recurso e verificá-lo podem fazer parte da mesma cadeia.

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

Escolhe onde o mock corre

Quando uma dependência real ainda não está pronta, um mock permite à equipa de frontend continuar a trabalhar e testar 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 estado de cada rota.

O desktop pode intercetar pedidos enviados dentro do Echo em qualquer plano, incluindo o Free. Para obteres um URL que outra aplicação ou pessoa possa chamar, publica um mock sincronizado no painel de hospedagem pública do Maestro, disponível no Echo Pro e Pro AI. Nesse plano publicas um mock do teu próprio espaço; para publicar um mock de equipa precisas da permissão Echo/ManageHosting. Um mock publicado continua a responder sem o desktop ligado. Consulta hospedagem pública de mocks para conheceres os passos de publicação, o acesso pelo URL público e os controlos operacionais.

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

Verifica contratos além das respostas

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

Agenda execuções

As execuções agendadas com cron verificam a API enquanto o Echo está em execução. Define o horário e o Echo avisa-te quando há uma falha, para poderes detetar um endpoint com problemas antes dos teus utilizadores. Os horários são sincronizados entre os dispositivos onde tens sessão iniciada, mas essa sincronização não os transforma em tarefas hospedadas.

Usa scripts quando precisares

Para os casos que exigem mais do que cadeias declarativas, o Echo suporta JavaScript antes e depois do pedido com a API pm.*, incluindo asserções. Se já escreveste scripts no Postman, a abordagem é familiar: verifica códigos de estado, corpos e cabeçalhos das respostas e faz a execução falhar quando o resultado não corresponde ao esperado.

Começa pelas cadeias, que são mais fáceis de ler e manter, e usa scripts quando precisares de lógica personalizada.

Próximos passos