Mocks remotos

Um mock remoto dá à sua equipe um endpoint HTTP antes de a dependência real estar pronta. Use para desenvolver o frontend, preparar uma demonstração compartilhada 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 respondendo sem o desktop ligado.

Os mocks locais interceptam requisições enviadas pelo próprio Echo; não abrem um servidor HTTP para outra aplicação.

Escolha onde o mock roda

  • Desktop local: mantenha as requisições na sua máquina enquanto cria e experimenta.
  • Mock hospedado: forneça a outra máquina uma URL que ela possa chamar diretamente.
  • Na sua aplicação .NET: use Mock.Client ou Mock.Server com regras obtidas por uma chave de aplicação. É uma opção separada da URL pública hospedada.

Publique o primeiro mock

  1. Abra Mocks no Maestro e selecione o espaço de trabalho ao qual o mock pertence.
  2. Crie um servidor e adicione uma rota com método HTTP, padrão de caminho, status e resposta. Escolha uma resposta estática ou um contrato. Você também pode partir de um mock salvo e sincronizado pelo desktop.
  3. Abra o painel de hospedagem do servidor e ative a hospedagem pública. Essa alteração requer as permissões de administrador do espaço de trabalho aceitas pelo painel.
  4. Copie a URL base exata apresentada no painel e acrescente o caminho da rota. O nome do host, por si só, não é um endpoint de mock.
  5. Chame a rota pela aplicação consumidora e verifique a resposta, incluindo X-Echo-Mock.

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

Compartilhe com intenção

Qualquer pessoa que conheça a URL pública pode chamar as rotas. Essa URL não é protegida por uma chave de aplicação eck_. Use dados inventados, mantenha credenciais fora dos corpos e cabeçalhos e compartilhe a URL apenas com quem precisa dela.

O painel permite desativar a hospedagem ou trocar o identificador público para obter uma nova URL. A troca 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 removida. Atualize o painel para consultar o estado atual.

Leve as regras para a aplicação

Aplicações e chaves explica a permissão separada ServeMocks, usada pelo feed de regras .NET. Escolha esse caminho quando sua aplicação deve servir ou interceptar requisições com regras do Echo, em vez de chamar a URL hospedada.