Echo

Da dúvida sobre a API à integração funcionando.

Explore um serviço, defina as respostas esperadas e teste o que acontece depois. O Echo reúne requisições, mocks, contratos e ferramentas .NET para desenvolvimento, QA e negócios trabalharem com exemplos concretos.

Conhecer os pacotes NuGet

Windows, macOS com Apple silicon, iOS e Android

  • HTTP
  • gRPC
  • GraphQL
  • WebSocket
  • SSE
Teste o checkout antes de a API ficar pronta. Escolha a resposta da API e veja o pedido reagir.
POST /orders
{
  "sku": "SKU-104",
  "quantity": 1
}
Sua aplicação
Mock HTTP do Echo
Resposta da API
2. O Echo responde 201 Created
{
  "orderId": 1042,
  "status": "confirmed"
}
3. Checkout de exemplo Compra confirmada

Pedido #1042 recebido. Acompanhe a preparação.

Pedido confirmadoVerifique se o pedido aceito pela API gera uma confirmação clara para o cliente.

2. O Echo responde 409 Conflict
{
  "code": "out_of_stock",
  "item": "SKU-104"
}
3. Checkout de exemplo Produto indisponível

Revise os itens antes de confirmar a compra.

Estoque insuficienteValide se a falta de estoque orienta o cliente a revisar os itens antes de tentar novamente.

2. O Echo responde 503 Service Unavailable
{
  "code": "temporarily_unavailable",
  "retryable": true
}
3. Checkout de exemplo Não foi possível concluir

Seu carrinho está preservado. Tente novamente.

Serviço indisponívelConfira se uma falha temporária preserva o carrinho e oferece uma nova tentativa.

Mock HTTP hospedado. Disponível no Pro e Pro AI.

Um exemplo. Um entendimento em comum.

Para quem desenvolve

Investigue uma API, reproduza uma falha e continue desenvolvendo com mocks. Leve os mesmos contratos e regras para sua aplicação .NET.

Para QA e testes

Transforme requisições salvas em verificações repetíveis. Varie os dados, compare respostas e compartilhe um relatório que mostre o que passou e o que precisa de atenção.

Para produto e negócios

Discuta um exemplo com a equipe técnica: pedido aprovado, pagamento pendente ou recusa. Combine o comportamento esperado antes que ele vire uma surpresa na entrega.

Entenda o que sua API está dizendo.

Trabalhe com HTTP, gRPC, GraphQL, WebSocket e SSE conforme seu plano. Configure a autenticação, reutilize variáveis e consulte histórico e cookies. Compare até quatro respostas, incluindo resultados reais e simulados, para investigar uma mudança com contexto.

Ler o guia
Encontre a mudança
Resposta A200 OK
{
  "orderId": 1042,
  "total": 49.90,
  "shipping": "included"
}
Resposta B200 OK
{
  "orderId": 1042,
  "total": 54.90
}

Comparação ilustrativa: o total muda de 49,90 para 54,90 e o campo shipping desaparece. Isso foi intencional? A diferença visível dá à equipe uma pergunta concreta para resolver.

Ler o guia

Avance enquanto a API fica pronta.

Um mock é uma resposta preparada antes de depender do serviço real. Use essa resposta para construir uma tela, testar um erro ou revisar a jornada do cliente. O Echo oferece uma forma de execução para cada necessidade.

Ler o guia
Escolha onde o mock responde Ilustração de três fluxos diferentes. Um mock no desktop não cria um endereço público para outras aplicações.
Echo
Regra de resposta
De onde vem a resposta
HTTP /orders/1042
Mock no desktop 200 OK
{
  "orderId": 1042,
  "status": "confirmed"
}

Crie e teste respostas simuladas dentro do Echo, inclusive no Free. Elas respondem às requisições do próprio Echo, sem abrir uma porta de rede para outras aplicações.

HTTP
Regra de resposta
De onde vem a resposta
HTTP https://mock.example/orders/1042
Mock hospedado 200 OK
{
  "orderId": 1042,
  "status": "confirmed"
}

Entregue a outra aplicação uma URL HTTP que continua respondendo com o desktop fechado. A hospedagem pública exige um plano Echo pago e as permissões adequadas.

.NET
Regra de resposta
De onde vem a resposta
.NET HttpClient / ASP.NET Core
Mock na sua aplicação 200 OK
{
  "orderId": 1042,
  "status": "confirmed"
}

Use Mock.Client e Mock.Server para interceptar chamadas HTTP de saída selecionadas ou responder a rotas ainda não implementadas da API com regras do feed remoto pago. Para snapshots portáteis, use API Explorer ou echo-mock.

Transforme um acordo em exemplos que podem ser testados.

Defina o que uma API deve retornar, explore cenários de sucesso e erro e revise o que muda entre versões. Desenvolvimento e negócios podem discutir os mesmos exemplos, sem depender de descrições separadas.

  1. 01

    Defina o modelo

    Descreva campos e tipos ou converta um modelo existente em um contrato com o qual você possa trabalhar.

  2. 02

    Explore os cenários

    Prepare exemplos de sucesso, resultado vazio e erro. Use esses exemplos para discutir o comportamento necessário na integração.

  3. 03

    Revise o impacto

    Versione o contrato, relacione provedores e consumidores e compare mudanças que podem afetar a compatibilidade.

Leve o Echo para dentro da sua aplicação .NET.

Sete pacotes NuGet conectam o contrato, o mock e o código que os utiliza. Escolha as peças necessárias para publicar um contrato, verificar um consumidor, simular uma dependência ou executar um snapshot HTTP preparado.

Ver configuração e exemplos de código
NuGet
dotnet add package Gapfy.Echo.ApiExplorer

Os pacotes estão disponíveis no NuGet. O feed remoto de regras exige um plano Echo pago e uma chave com o escopo adequado. Snapshots offline preparados funcionam sem uma chave de aplicação online; a preparação e a revisão continuam necessárias.

Gapfy.Echo.Contracts

Publique versões dos contratos fornecidos pela sua aplicação para que os consumidores possam revisar o que esperar.

Gapfy.Echo.Testing

Verifique os contratos consumidos contra snapshots revisados nos seus testes automatizados.

Gapfy.Echo.Mock.Client

Intercepte chamadas HTTP de saída selecionadas para que sua aplicação utilize uma resposta simulada.

Gapfy.Echo.Mock.Server

Responda a rotas ainda não implementadas da API ASP.NET Core enquanto os endpoints reais são desenvolvidos.

Gapfy.Echo.ApiExplorer

Explore e execute endpoints HTTP em um painel no navegador, escolhendo o comportamento real ou simulado.

Gapfy.Echo.Offline

Valide snapshots portáteis com regras de mock, contratos e perfis.

API Explorer

API real ou mock, endpoint por endpoint

Neste exemplo, /orders e /inventory consultam a API real; /payments usa uma resposta simulada.

O API Explorer descobre e executa endpoints HTTP da sua aplicação. Escolha o comportamento real ou simulado por endpoint e identifique se a mudança vale para sua sessão ou para a instância da aplicação. O suporte a gRPC do desktop não se estende a esse painel HTTP.

echo-mock

Um snapshot pronto para os seus testes

O arquivo snapshot.json reúne os exemplos revisados que echo-mock usa nos testes ou no CI.

Reúna regras, contratos e perfis em um snapshot, revise o conteúdo e execute com echo-mock em testes ou CI. O snapshot não precisa do feed remoto durante a execução. Ele não bloqueia todas as outras chamadas de rede que sua aplicação possa fazer.

Deixe o próximo teste mais fácil de repetir.

Execute coleções com dados CSV ou JSON, adicione scripts pm.* e encadeie requisições com JSONPath. Use gapfy-echo para executar coleções e cadeias pelo terminal. Revise verificações e tempos, depois exporte JUnit XML para suas ferramentas ou um relatório HTML para compartilhar.

Ler o guia
  1. Dados de testeCSV / JSON
  2. Execução da coleçãopm.test / JSONPath
  3. Relatório para compartilharJUnit / HTML
Fluxo ilustrativo: os dados de teste alimentam a execução da coleção, que gera um relatório para revisão.

Dê algo concreto para a conversa avançar.

Compartilhe coleções com Leitura, Contribuição ou Acesso Total e sincronize requisições e ambientes ao entrar na conta. Um plano Echo pago também permite publicar documentação versionada das coleções. Leve exemplos e relatórios às revisões de produto para tecnologia e negócios discutirem o mesmo comportamento.

Ler o guia

Tenha suas requisições salvas sempre à mão.

O aplicativo complementar para iOS e Android permite acessar coleções, usar ambientes, inspecionar respostas e executar scripts sincronizados no celular. Os executores de coleções, a edição de scripts, o editor de mocks e os painéis de IA ficam no desktop. Histórico e cookies permanecem no dispositivo que os criou.

Ler o guia

Explore todas as possibilidades

Escolha um fluxo e abra o guia para conhecer a configuração, os recursos e os limites. Desktop, celular, hospedagem e pacotes .NET atendem a partes diferentes do trabalho.

Cinco protocolos, um editor

Use HTTP e gRPC, ou GraphQL, WebSocket e SSE conforme seu plano. Explore esquemas, acompanhe fluxos de dados e inspecione respostas no painel de cada protocolo.

Ler o guia

Compare entre ambientes

Compare a mesma requisição em até quatro painéis de resposta, incluindo resultados reais e simulados. A comparação estrutural de JSON e a rolagem sincronizada ajudam a investigar o que mudou.

Ler o guia

Coleções feitas para times

Organize requisições em espaços e pastas aninhadas, usando arrastar e soltar e ações em lote. Compartilhe coleções com Leitura, Contribuição ou Acesso Total para cada pessoa.

Ler o guia

Ambientes e variáveis

Troque de ambiente e reutilize valores {{variable}} com destaque e preenchimento automático. Uma variável pode guardar uma referência ao Azure Key Vault, com o valor resolvido quando necessário.

Ler o guia

Automação sem cerimônia

Execute coleções com dados de teste CSV ou JSON, encadeie requisições com JSONPath e adicione scripts pm.*. Confira os resultados e exporte um relatório JUnit XML para suas ferramentas ou HTML para compartilhar.

Ler o guia

Privado por design

Comece no modo convidado, sem conta, e mantenha seu trabalho em um banco de dados criptografado no dispositivo. Você pode preparar dados salvos offline; chamar uma API remota ainda exige acesso ao serviço.

Ler o guia

Sincronização que acompanha você

Use o Echo no Windows e em Macs com Apple silicon, incluindo iMac e MacBook. Entre para sincronizar coleções e ambientes; o aplicativo para iOS e Android permite acessar suas requisições salvas pelo celular.

Ler o guia

Traga suas coleções

Importe Postman, Insomnia, Bruno e OpenAPI. A importação de cURL usa IA e exige uma licença Pro AI. Exporte coleções como Postman ou OpenAPI 3.1, ou vincule uma pasta e escolha quando importar ou exportar seus arquivos.

Ler o guia

Mocks e verificações que continuam online

Um plano pago do Echo permite hospedar mocks HTTP e agendar verificações que rodam com o aplicativo fechado. As verificações hospedadas aceitam HTTP e operações query e mutation do GraphQL, com intervalo mínimo de 5 minutos.

Ler o guia

Encontre mudanças nos contratos a tempo

Publique contratos de API versionados, vincule aplicações às versões que usam e compare mudanças para consumidores e fornecedores para encontrar possíveis incompatibilidades antes de lançar.

Ler o guia

Escolha por onde começar.

Use o aplicativo desktop para o fluxo completo de edição e testes no Windows ou em um Mac com Apple silicon. Adicione o aplicativo complementar para iOS ou Android quando precisar das requisições salvas no celular.

Comece com requisições, mocks no desktop e contratos. A hospedagem pública, o feed remoto de regras e os recursos de IA dependem do plano e das permissões aplicáveis.

Free, Pro e Pro AI

Comece no Free testando APIs localmente. O Pro inclui mocks hospedados, limites mais amplos e controles de time; o Pro AI adiciona o assistente que escreve testes e explica falhas.

Free Grátis Grátis para sempre
Pro EUR 9/ assento / mês 14 dias de teste grátis
AI Pro AI EUR 16/ assento / mês 14 dias de teste grátis
Coleções
100
10.000
10.000
Requests salvos
1.000
100.000
100.000
Ambientes por espaço
3
20
20
Histórico de execuções por request
50
200
200
Mocks no desktop
check
check
check
Hospedagem pública de mocks
remove
check
check
Protocolos
HTTP, gRPC
Todos os protocolos
Todos os protocolos
Diff de ambientes lado a lado
check
check
check
Workspaces compartilhados, SSO e audit trail
remove
check
check
Explicação de erro e request-a-partir-de-spec por AI
remove
remove
check
Asserções, mocks e geração de testes por AI
remove
remove
check