Pular para o conteúdo principal

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.

  1. Crie um novo grupo (ex.: Meu Primeiro Grupo).
  2. 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 protocoloExemplo de endereço baseNotas
HTTPhttp://127.0.0.1:18080Use https:// para ativar TLS
WebSocketws://127.0.0.1:18085Use wss:// para ativar TLS
gRPCgrpc://127.0.0.1:18089Use grpcs:// para ativar TLS
MQTTmqtt://127.0.0.1:18884Use 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://… ou wss://…; se acidentalmente digitar https://…, 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:

  1. Protocolo: HTTP; Método: GET.
  2. URL — preencha apenas o fragmento de caminho: /echo (não o host completo — o host já é fornecido pelo Pre-URL http do ambiente).
  3. 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)