Hospedagem pública de mocks

Um mock dá à tua equipa respostas 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 responder aos próprios pedidos no desktop ou publicar o mock no serviço público em mock.gapfy.io, onde ganha um URL HTTP que outra aplicação pode chamar. Um mock publicado 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. Está incluído em todos os planos do Echo, incluindo o Free.
  • Hospedagem pública: fornece a outra máquina um URL que pode chamar diretamente. Faz parte do Echo Pro e Pro AI.
  • Na tua aplicação .NET: usa Mock.Client ou Mock.Server com regras obtidas através de uma chave de aplicação. É um caminho diferente do URL público, mas o feed de regras faz parte dos mesmos planos pagos.

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 pública do servidor e ativa a publicação. Publicar requer um plano Echo Pro ou Pro AI. Dentro desse plano publicas um mock do teu próprio espaço por seres o dono dele; publicar um mock de uma equipa requer a permissão Echo/ManageHosting, atribuída por omissão ao administrador da organização.
  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.

Num plano gratuito, o painel abre e mostra o estado, mas não permite ativar a hospedagem pública nem rodar a chave pública: explica que esta funcionalidade não está incluída no plano, enquanto o mock no desktop e os contratos continuam disponíveis. Não é uma permissão em falta que um administrador possa conceder. Para publicar, pede a quem gere a subscrição da organização que atualize o plano do Echo em Definições > Faturação.

Limites da hospedagem pública

Um plano pago permite manter até 25 mocks publicados em simultâneo por organização. Este é um limite rígido: a publicação de outro mock é recusada até desativares um dos publicados. O serviço também mede 50 000 pedidos por mês por assento. Ultrapassar esta franquia mensal não recusa pedidos por esse motivo; continuam a aplicar-se os controlos operacionais de tráfego do serviço.

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 pública ou rodar o identificador público para obter um novo URL. A rotação exige atualizar os clientes. Se a subscrição deixar de incluir hospedagem pública, depois de terminado qualquer período de tolerância, um mock já publicado não é apagado: o URL e a chave pública mantêm-se. Quem chama recebe 503 com o código mock-server-suspended e o cabeçalho Retry-After: 300; o motivo mostrado no painel não é exposto no URL público. Quando voltar a existir um plano elegível, o mesmo URL volta a responder sem nova publicação. A alteração pode demorar até cerca de cinco minutos a refletir-se.

Uma suspensão manual aplicada pela plataforma é diferente: só um operador a pode levantar. Um bloqueio global pode terminar automaticamente no prazo definido pelo operador. O proprietário não consegue reativar o mock enquanto qualquer um deles se mantiver. Atualiza o painel para consultar o estado atual.

Leva as regras para a aplicação

Aplicações e chaves explica o scope separado ServeMocks, usado 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 da hospedagem pública. Este feed faz parte do Echo Pro e Pro AI, mesmo quando as regras não estão publicadas no serviço público.