Requisições e protocolos
Crie uma requisição, escolha o protocolo e indique o endereço a consultar. O Echo mantém a requisição, a resposta e o histórico juntos. Salve as chamadas úteis numa coleção para as voltar a executar ou incluir num teste.
Enviar uma requisição HTTP
Selecione o método e acrescente parâmetros de consulta e cabeçalhos. Pode ativar ou desativar cada linha sem a excluir. O corpo aceita texto, JSON, XML, formulários URL-encoded, multipart com arquivos e um arquivo binário. A formatação de JSON e XML facilita a leitura de corpos extensos.
Use {{baseUrl}}/orders para evitar repetir o endereço do servidor. As variáveis também funcionam em cabeçalhos, corpo e autenticação. Consulte ambientes e variáveis.
Nas configurações da requisição, ajuste o tempo limite, os redirecionamentos e a quantidade máxima, a codificação da URL, a validação TLS e o uso dos cookies salvos. Preservar o método original mantém método e corpo nos redirecionamentos 301 e 302; 303 continua a mudar para GET. Mantenha a validação de certificados ativa no uso normal.
Escolher a autenticação
Configure cada requisição e use variáveis para reutilizar credenciais.
| Método | Informação necessária |
|---|---|
| Bearer | Token de acesso |
| Basic | Nome de usuário e senha |
| API key | Nome, valor e envio no cabeçalho ou na consulta |
| OAuth2 client credentials | URL de token, client ID, client secret e âmbito |
| OAuth2 authorization code com PKCE | URLs de autorização e token, client ID, URI de redirecionamento e âmbito ou audience exigidos |
| AWS Signature V4 | Access key, secret key, região, serviço e session token opcional |
| Digest ou NTLM | Credenciais do servidor; NTLM também aceita domínio |
| Hawk | Identificador da credencial, chave e algoritmo |
Os tokens de client credentials são reutilizados entre chamadas enquanto forem válidos. Authorization code abre o navegador e exige uma sessão interativa e uma URI de redirecionamento registada no fornecedor de identidade da API.
A opção de herdar autenticação ainda não resolve uma configuração editável da coleção superior. Defina a autenticação na própria requisição. Ao importar do Postman, a autenticação herdada suportada é copiada para as requisições.
Chamar um serviço gRPC
Indique o servidor, descubra os serviços e selecione um método. A descoberta usa reflexão. Se o servidor não a disponibilizar, pode anexar um arquivo .proto com as definições necessárias à chamada.
Escreva a mensagem em JSON. Unary e server streaming recebem um objeto. Client streaming e streaming bidirecional recebem um array, como [{"name":"first"},{"name":"second"}]. O Echo envia as mensagens por ordem e apresenta as recebidas na visualização do fluxo. Use Parar para terminar uma chamada em curso.
Explorar GraphQL
Escreva a query ou mutation, forneça as variáveis em JSON e indique o nome da operação quando necessário. A introspeção carrega o schema para consultar campos e inserir modelos de query, mutation ou subscription. Se estiver desativada no servidor, continua a ser possível escrever a operação.
Para subscriptions, ative esse modo e use o endereço ws:// ou wss:// do serviço. Acompanhe os eventos na visualização do fluxo. Consulte também o campo errors: um status HTTP 200 pode acompanhar um erro da operação GraphQL.
Usar WebSocket e SSE
Uma requisição WebSocket abre a ligação e permite enviar mais mensagens enquanto permanece ativa. Escolha texto ou binário; o modo binário aceita bytes hexadecimais como DE AD BE EF. Pode consultar frames enviados e recebidos, filtrar a lista e limpar o conteúdo apresentado.
SSE recebe eventos do servidor. A reconexão automática pode seguir o intervalo sugerido pelo servidor e o identificador do último evento. Nas configurações, pode desativar a reconexão e ajustar o tempo limite de inatividade de WebSocket e SSE. Use Parar quando já tiver os eventos necessários.
Consultar a resposta
Leia status, cabeçalhos, corpo, cookies e resultados dos testes. O console de scripts ajuda a perceber asserções falhadas. No histórico, reabra uma resposta, comparação ou execução de coleção. Pode transformar uma resposta HTTP registada numa rota de mock depois de rever o conteúdo.
O painel de tempo mostra as medições disponíveis, incluindo DNS, ligação, TLS, primeiro byte e download. Uma ligação reutilizada pode não ter uma nova medição em todas as fases. Quando existe histórico suficiente de requisições salvas com sucesso, o Echo compara a duração e pode assinalar uma resposta mais lenta. O limite percentual é configurável. Trata-se de uma comparação com o histórico, não de um teste de carga.
Cookies, proxy e certificados de cliente
O gestor de cookies permite consultar, editar e excluir cookies do host atual, limpar os desse host ou importar um cabeçalho Cookie. Desative o seu uso na requisição para testar sem uma sessão salva.
As configurações avançadas oferecem proxy do sistema, desativado ou manual, com credenciais e exceções. Para TLS mútuo, associe um padrão de host a um certificado PFX ou à impressão digital de um certificado no repositório do sistema. Estas configurações e os caminhos dos arquivos pertencem ao dispositivo. Prepare-os em cada máquina que execute as chamadas.
Consulte o modo de comparação para comparar ambientes e a automação para repetir chamadas com verificações.