Requisições e protocolos
Crie uma requisição, escolha o protocolo e informe o endereço que deseja chamar. O Echo mantém a requisição, a resposta e o histórico juntos. Salve as requisições úteis em uma coleção para executá-las novamente ou incluí-las em um teste.
Envie uma requisição HTTP
Escolha o método e acrescente parâmetros de consulta e cabeçalhos. Você pode ativar ou desativar cada linha sem excluí-la. O editor de corpo aceita texto, JSON, XML, formulários URL-encoded, formulários multipart com arquivos e um arquivo binário. Use a formatação de JSON ou XML para ler um corpo maior.
Prefira {{baseUrl}}/orders a repetir o endereço do servidor. Variáveis também funcionam em cabeçalhos, valores do corpo e configurações de autenticação. Consulte ambientes e variáveis.
As configurações da requisição controlam o tempo limite, os redirecionamentos e sua quantidade máxima, a codificação da URL, a validação do certificado TLS e o uso dos cookies salvos. A opção de preservar o método original mantém método e corpo nos redirecionamentos 301 e 302; o código 303 continua mudando para GET. Mantenha a validação de certificados ativada no uso normal.
Configure a autenticação
Configure a autenticação em cada requisição. Use variáveis para reutilizar credenciais.
| Método | Informações necessárias |
|---|---|
| Bearer | Token de acesso |
| Basic | Usuário e senha |
| API key | Nome e valor da chave, enviados no cabeçalho ou na consulta |
| OAuth2 client credentials | URL de token, client ID, client secret e escopo |
| OAuth2 authorization code com PKCE | URLs de autorização e token, client ID, URI de redirecionamento e escopo ou audience exigidos |
| AWS Signature V4 | Access key, secret key, região, serviço e session token opcional |
| Digest ou NTLM | Credenciais exigidas pelo servidor; NTLM também aceita domínio |
| Hawk | Identificador da credencial, chave e algoritmo |
Tokens de client credentials são reaproveitados entre requisições enquanto estiverem válidos. O fluxo authorization code abre o navegador e precisa de uma sessão interativa e de uma URI de redirecionamento registrada no provedor de identidade da API.
A opção de herdar autenticação ainda não resolve uma configuração editável da coleção pai. Configure o método diretamente na requisição. Na importação do Postman, a autenticação herdada compatível é copiada para as requisições importadas.
Chame um serviço gRPC
Informe o endereço do servidor, descubra os serviços e selecione um método. A descoberta usa reflexão do servidor. Também é possível anexar um arquivo .proto quando a reflexão não estiver disponível; ele precisa conter as definições usadas pela chamada.
Escreva a mensagem em JSON. Chamadas 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 em ordem e mostra as mensagens recebidas na visualização do fluxo. Use Parar para encerrar uma chamada em andamento.
Explore GraphQL
Escreva uma query ou mutation, informe as variáveis em JSON e defina o nome da operação quando necessário. A introspecção carrega o schema para consultar campos e inserir modelos de query, mutation ou subscription. Se o servidor desativar a introspecção, você ainda pode 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. Confira o campo errors do GraphQL além do status HTTP: uma resposta 200 pode conter um erro da operação.
Use WebSocket e SSE
Uma requisição WebSocket abre a conexão e permite enviar outras mensagens enquanto ela estiver ativa. Escolha texto ou binário; a entrada binária aceita bytes hexadecimais, como DE AD BE EF. A visualização mostra os frames enviados e recebidos e permite filtrar ou limpar a lista exibida.
SSE recebe eventos do servidor. A reconexão automática pode usar o intervalo sugerido pelo servidor e o identificador do último evento. Nas configurações, você pode desativá-la e ajustar o tempo limite de inatividade para WebSocket e SSE. Use Parar quando já tiver os eventos necessários.
Leia a resposta
Confira status, cabeçalhos, corpo, cookies e resultados dos testes. O console de scripts ajuda a entender asserções que falharam. O histórico permite reabrir uma resposta anterior, uma comparação ou uma execução de coleção. Uma resposta HTTP registrada também pode virar uma rota de mock, depois da revisão do conteúdo.
O painel de tempo mostra as medições disponíveis, incluindo DNS, conexão, TLS, primeiro byte e download. Uma conexão reaproveitada pode não ter nova medição em todas as etapas. Com histórico suficiente de requisições salvas bem-sucedidas, o Echo compara a duração e pode sinalizar uma resposta mais lenta. Ajuste o limite percentual nas configurações. Essa comparação usa seu histórico; ela não substitui um teste de carga.
Cookies, proxy e certificados de cliente
O gerenciador de cookies permite consultar, editar e excluir cookies do host atual, limpar os cookies desse host ou importar um cabeçalho Cookie. Desative 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 regras de exceção. 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. Essas configurações e os caminhos de arquivos pertencem ao dispositivo e precisam ser preparados em cada máquina.
Use o modo de comparação para consultar ambientes diferentes ou a automação para repetir as chamadas com verificações.