Pedidos e protocolos

O Echo reúne cinco protocolos num único editor, para deixares de alternar entre ferramentas quando uma API não é apenas HTTP.

Os cinco protocolos

HTTP: o editor de pedidos do dia a dia, com método, cabeçalhos, corpo e autenticação por pedido.
gRPC: transporte real baseado em reflexão. O Echo descobre serviços diretamente no servidor e suporta chamadas unárias e todos os modos de streaming.
GraphQL: introspeção, variáveis e subscrições.
WebSocket: estabelece a ligação e envia mensagens de forma interativa, com uma vista hexadecimal dos frames que não são texto.
SSE: subscreve fluxos de eventos enviados pelo servidor e restabelece a ligação automaticamente quando o fluxo é interrompido.

Escolhes o protocolo quando crias um pedido e o editor adapta-se a ele.

Autenticação

A autenticação é configurada por pedido, com herança das coleções pai. Define Bearer, Basic, chave de API ou OAuth2 client credentials uma vez numa coleção, e todos os pedidos nela contidos usam essa configuração, a menos que um pedido a substitua pela sua própria.

Os tokens de OAuth2 client credentials são guardados em cache, por isso os envios repetidos não voltam a negociar um token de cada vez.

Lê as respostas

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

O histórico de pedidos guarda as chamadas anteriores e permite filtrá-las, para encontrares facilmente o pedido que falhou ontem.
O gestor de cookies regista os cookies e inclui um editor, útil quando precisas de inspecionar ou ajustar uma sessão manualmente.

Detalhe dos tempos de rede

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

O Echo também mantém uma linha de base para os teus pedidos e mostra um aviso "mais lento do que o habitual" quando uma chamada fica para trás, para que uma regressão se destaque antes de alguém abrir um ticket.

Trabalha com eficiência

Vale a pena criares desde cedo alguns hábitos:

Abre a vista dividida para trabalhar com até 4 painéis lado a lado, por exemplo um pedido, o respetivo pedido gRPC e duas chamadas de referência.
Usa a paleta de comandos para ires a qualquer parte sem tirares as mãos do teclado.
Reconfigura os atalhos para corresponderem aos hábitos que já tens noutras ferramentas.

Próximos passos

Deixa de fixar nomes de host e tokens no pedido: /docs/echo/environments-and-variables
Executa o mesmo pedido em vários ambientes ao mesmo tempo: /docs/echo/environments-and-variables
Transforma pedidos em verificações automatizadas: /docs/echo/automation