Início rápido · Sua primeira requisição em três passos
Objetivo: montar uma requisição HTTP funcional do zero. Uma vez entendida a linha principal 'Grupo → Ambiente → Requisição', todo outro protocolo é apenas um protocolo e um Pre-URL diferentes.
Passo 1: Crie um grupo, vincule um ambiente
No Quick Request, o ambiente é vinculado ao grupo, e todas as requisições do grupo o compartilham.
- Crie um novo grupo (ex.:
Meu Primeiro Grupo). - Vincule um ambiente ao grupo. Se ainda não tiver um, crie um ambiente primeiro (ex.:
Local).
Por que a camada extra? Porque quando um módulo se move entre dev / staging / produção, você só quer editar o ambiente — não dezenas de requisições.
Passo 2: Preencha o Pre-URL no ambiente
Um ambiente mantém um endereço base por protocolo. Para enviar HTTP, preencha a entrada http:
| Linha do protocolo | Exemplo de endereço base | Notas |
|---|---|---|
| HTTP | http://127.0.0.1:18080 | Use https:// para ativar TLS |
| WebSocket | ws://127.0.0.1:18085 | Use wss:// para ativar TLS |
| gRPC | grpc://127.0.0.1:18089 | Use grpcs:// para ativar TLS |
| MQTT | mqtt://127.0.0.1:18884 | Use mqtts:// para ativar TLS |
⚠️ A armadilha mais fácil: a qual protocolo um endereço base pertence é decidido pelo scheme no início da URL, não pela linha em que você o digitou. Um endereço base WebSocket deve ser escrito como
ws://…ouwss://…; se acidentalmente digitarhttps://…, será tratado como HTTP, a requisição WebSocket não encontra endereço base e falha. Mantenha a linha do protocolo e o scheme consistentes.
(As portas como 18080 acima vêm do servidor de teste de exemplo; substitua pelos seus endereços reais ao testar suas próprias APIs.)
Passo 3: Crie uma requisição, preencha apenas o fragmento de caminho, envie
Crie uma requisição dentro do grupo:
- Protocolo: HTTP; Método:
GET. - URL — preencha apenas o fragmento de caminho:
/echo(não o host completo — o host já é fornecido pelo Pre-URLhttpdo ambiente). - Toque em Enviar.
Você verá /echo ecoar exatamente o que enviou. O que realmente foi pela rede foi http://127.0.0.1:18080/echo.
Funcionou — e agora?
- Quer entender 'por que apenas
/echo' e 'de onde vem{{x}}' → concepts - Quer assinar requisições antes de enviar / descriptografar respostas → scripts
- Quer copiar a receita 'login para token, anexação automática para todo o grupo' → recipes
- Trocar de protocolo (WS/TCP/UDP/gRPC/MQTT) → a página correspondente do protocolo (veja o índice)