Requisições e protocolos

O Echo reúne cinco protocolos em um único editor, para você parar de alternar entre ferramentas quando uma API não usa apenas HTTP.

Os cinco protocolos

HTTP: o editor de requisições do dia a dia, com método, cabeçalhos, corpo e autenticação por requisição.
gRPC: transporte real baseado em reflexão. O Echo descobre serviços diretamente no servidor e oferece chamadas unárias e todos os modos de streaming.
GraphQL: introspecção, variáveis e assinaturas.
WebSocket: estabelece a conexão e envia mensagens de forma interativa, com uma visualização hexadecimal para frames que não são de texto.
SSE: assina fluxos de eventos enviados pelo servidor e restabelece a conexão automaticamente quando o fluxo cai.

Você escolhe o protocolo ao criar uma requisição, e o editor se adapta a ele.

Autenticação

A autenticação é configurada por requisição, com herança das coleções pai. Defina Bearer, Basic, chave de API ou OAuth2 client credentials uma vez em uma coleção, e todas as requisições dentro dela usarão essa configuração, a menos que uma requisição a substitua pela sua própria.

Os tokens de OAuth2 client credentials ficam em cache, então os envios repetidos não voltam a negociar um token toda vez.

Leia as respostas

O visualizador de respostas mostra o status, os cabeçalhos e o corpo de cada chamada. Duas ferramentas ajudam você a trabalhar ao longo do tempo:

O histórico de requisições guarda suas chamadas anteriores e permite filtrá-las, para você encontrar facilmente a requisição que falhou ontem.
O gerenciador de cookies registra os cookies e inclui um editor, útil quando você precisa inspecionar ou ajustar uma sessão manualmente.

Detalhes dos tempos de rede

Cada resposta inclui os detalhes dos tempos de rede: DNS, TCP, TLS, tempo até o primeiro byte e transferência. Assim, "a API parece lenta" passa a ter uma resposta concreta sobre onde o tempo realmente foi gasto.

O Echo também mantém uma linha de base para suas requisições e mostra um aviso "mais lenta do que o habitual" quando uma chamada fica para trás, para que uma regressão se destaque antes que alguém abra um chamado.

Trabalhe com eficiência

Vale a pena criar alguns hábitos desde cedo:

Abra a visualização dividida para trabalhar com até 4 painéis lado a lado, por exemplo uma requisição, a requisição gRPC relacionada e duas chamadas de referência.
Use a paleta de comandos para ir a qualquer lugar sem tirar as mãos do teclado.
Reconfigure os atalhos para corresponderem aos hábitos que você já tem em outras ferramentas.

Próximos passos

Pare de fixar nomes de host e tokens na requisição: /docs/echo/environments-and-variables
Execute a mesma requisição em vários ambientes ao mesmo tempo: /docs/echo/environments-and-variables
Transforme requisições em verificações automatizadas: /docs/echo/automation