Mocks remotos

Um mock remoto dá à tua equipa um endpoint HTTP antes de a dependência real estar pronta. Serve para desenvolver o frontend, preparar uma demonstração partilhada ou testar erros e atrasos de propósito. O Echo pode executar um mock localmente no desktop ou publicá-lo no serviço hospedado em mock.gapfy.io. Um mock hospedado continua a responder sem o desktop ligado.

Os mocks locais intercetam pedidos enviados pelo próprio Echo; não abrem um servidor HTTP para outra aplicação.

Escolhe onde o mock corre

  • Desktop local: mantém os pedidos na tua máquina enquanto crias e experimentas.
  • Mock hospedado: fornece a outra máquina um URL que pode chamar diretamente.
  • Na tua aplicação .NET: usa Mock.Client ou Mock.Server com regras obtidas através de uma chave de aplicação. É uma opção separada do URL público hospedado.

Publica o primeiro mock

  1. Abre Mocks no Maestro e seleciona o espaço de trabalho a que o mock pertence.
  2. Cria um servidor e adiciona uma rota com método HTTP, padrão de caminho, estado e resposta. Escolhe uma resposta estática ou um contrato. Também podes partir de um mock guardado e sincronizado pelo desktop.
  3. Abre o painel de hospedagem do servidor e ativa a hospedagem pública. Esta alteração requer as permissões de administrador do espaço de trabalho aceites pelo painel.
  4. Copia o URL base exato apresentado no painel e acrescenta o caminho da rota. O nome do host, por si só, não é um endpoint de mock.
  5. Chama a rota a partir da aplicação consumidora e verifica a resposta, incluindo X-Echo-Mock.

Os contratos permitem gerar respostas estruturadas e manter versões. As respostas estáticas servem quando precisas de um corpo exato.

Partilha com intenção

Qualquer pessoa que conheça o URL público pode chamar as rotas. Esse URL não é protegido por uma chave de aplicação eck_. Usa dados inventados, mantém credenciais fora dos corpos e cabeçalhos e partilha o URL apenas com quem precisa dele.

O painel permite desativar a hospedagem ou rodar o identificador público para obter um novo URL. A rotação exige atualizar os clientes. Os operadores da plataforma podem suspender a hospedagem ou aplicar um bloqueio global; o proprietário não consegue ativar um mock suspenso até a suspensão ser levantada. Atualiza o painel para consultar o estado atual.

Leva as regras para a aplicação

Aplicações e chaves explica a permissão separada ServeMocks, usada pelo feed de regras .NET. Escolhe este caminho quando a tua aplicação deve servir ou intercetar pedidos com regras do Echo, em vez de chamar o URL hospedado.